MCP Server

Cập nhật lần cuối: 2026-07-06

MCP Server là gì?

MCP (Model Context Protocol) Server cho phép các trợ lý AI bên ngoài như Claude Desktop, Cursor, Windsurf truy cập dữ liệu HaMi Code Việt thông qua các công cụ (tools) chuẩn. Điều này cho phép bạn hỏi Claude về khóa học, bài học, chạy code, tạo câu hỏi trắc nghiệm và kiểm tra tiến độ — tất cả từ trong Claude.

5 công cụ

Công cụ	Chức năng
`course_lookup`	Tìm khóa học theo từ khóa, cấp độ, độ tuổi
`lesson_lookup`	Xem nội dung bài học theo ID
`code_execute`	Chạy code Python/JavaScript qua Piston
`quiz_generate`	Tạo câu hỏi trắc nghiệm theo chủ đề
`progress_check`	Kiểm tra tiến độ học tập của người dùng

Cài đặt với Claude Desktop

Thêm vào file claude_desktop_config.json:

{
  "mcpServers": {
    "hamicodeviet": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "HAMICO_API_URL": "https://api.hamicodeviet.com",
        "HAMICO_API_KEY": "your-api-key",
        "PISTON_API_URL": "https://emkc.org/api/v2/piston"
      }
    }
  }
}

Cài đặt với Cursor

Thêm vào ~/.cursor/mcp.json với cấu hình tương tự.

Cài đặt với Windsurf

Thêm vào ~/.codeium/windsurf/mcp_config.json với cấu hình tương tự.

Biến môi trường

HAMICO_API_URL — URL API HaMi Code Việt
HAMICO_API_KEY — API key của bạn
PISTON_API_URL — URL Piston API (mặc định: emkc.org)

Piston self-host

Để tăng cường quyền riêng tư, bạn có thể tự host Piston:

docker run -p 2000:2000 -d ghcr.io/engineer-man/piston

Sau đó đặt PISTON_API_URL=http://localhost:2000.

Mã nguồn

Mã nguồn MCP server nằm trong thư mục mcp-server/ của repository.

Tích hợp với aiagent.iai.one

MCP Server có thể kết nối trực tiếp với nền tảng AI tự học aiagent.iai.one để mở rộng khả năng agent. Khi cấu hình, đặt thêm biến môi trường:

AIAGENT_BASE_URL — https://aiagent.iai.one
AIAGENT_API_KEY — API key từ aiagent.iai.one (nếu có)

Điều này cho phép MCP server gọi trực tiếp các agent từ aiagent.iai.one, bên cạnh API HaMi Code Việt.