DataCore A2A MCP server

DataCore A2A — MCP server

<!-- mcp-name: vn.datacore/datacore-a2a --> <!-- Marker dự phòng: registry tìm chuỗi con, nên hai dòng cùng tồn tại được. Giữ đường lùi nếu xác minh tên miền không xong, khỏi phải phát hành một version mới chỉ để sửa một dòng comment. mcp-name: io.github.nambn3tit/datacore-a2a-mcp -->

Cho phép một MCP client (Claude Code, Claude Desktop, VS Code, Cursor…) dùng các skill dữ liệu của DataCore như tool native: chuẩn hoá địa chỉ Việt Nam, kiểm tra địa chỉ, tra cứu doanh nghiệp, sinh embedding.

MCP client (stdio) ──► datacore-mcp ──HTTPS──► DataCore API

Zero dependency, Python 3.9+.

Cài đặt

pip install datacore-a2a-mcp

Cần có trước

Server này là client, không phải dịch vụ. Nó cần một endpoint DataCore và một mandate token để gọi — liên hệ 3TIT để được cấp. Không có hai thứ đó thì server khởi động rồi thoát ngay kèm thông báo thiếu biến nào.

Cấu hình

Dùng đúng URL DataCore cấp kèm mandate. Một endpoint khác sẽ không nhận mandate của bạn và trả 401.

Claude Code / Claude Desktop

Thêm vào .mcp.json (project) hoặc config của Claude Desktop:

{
  "mcpServers": {
    "datacore-a2a": {
      "command": "datacore-mcp",
      "env": {
        "DATACORE_A2A_URL": "https://api.example.com",
        "DATACORE_MANDATE": "<mandate-token>"
      }
    }
  }
}

Tool

Tool list được sinh từ endpoint, không hardcode ở đây — nên khi DataCore thêm skill, restart server là thấy tool mới.

Mặc định expose 4 skill đã nối backend thật:

Mọi tool là read-only (readOnlyHint: true): không ghi, không xoá, không tạo gì. Gọi lại cùng input cho cùng kết quả.

Ba skill khác của DataCore (company.graph, company.financial-sankey, company.news) cố ý không được expose: chúng đang trả dữ liệu mock/deterministic. Muốn thấy chúng để thử thì đặt DATACORESKILLS="", và đừng tin kết quả.

Ví dụ

Ba prompt dưới đây chạy qua ba tool khác nhau:

Thai To, Hoan Kiem, Ha Noi"

1. Chuẩn hoá địa chỉ — "Chuẩn hoá địa chỉ này thành tỉnh/huyện/xã: So 1 Ly

0100109106 và cho tôi biết trạng thái hoạt động"

1. Tra cứu doanh nghiệp — "Tìm thông tin doanh nghiệp có mã số thuế

vector có bao nhiêu chiều: bán buôn thiết bị điện tử"

1. Embedding — "Sinh embedding cho đoạn mô tả ngành nghề này rồi cho biết

Mô hình bảo mật

Server này mang mandate token nguyên dạng ở header X-AP2-Mandate để phía DataCore verify, và không tự khai bất kỳ header authorization nào khác. Một client không được là nơi tự cấp quyền cho chính nó — nó chỉ chuyển tiếp thứ nó được cấp, còn mọi quyết định cho phép hay từ chối đều nằm ở phía DataCore.

Mandate là bearer credential: ai giữ nó cũng gọi được đúng những skill trong đó, tới hết hạn mức, cho tới khi hết hạn. Giữ nó như giữ mật khẩu — đừng commit .mcp.json đã điền token, và nếu client của bạn hỗ trợ, đọc nó từ trình quản lý secret thay vì để inline.

Shortened. The full README is on GitHub.