DataCore A2A — MCPサーバー

MCPクライアント（Claude Code、Claude Desktop、VS Code、Cursorなど）が、DataCoreのデータスキルをネイティブツールとして使用できるようにします。ベトナム住所の標準化、住所チェック、企業検索、embedding生成などに対応します。

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

Zero dependency、Python 3.9+。

インストール

pip install datacore-a2a-mcp

Related MCP server: database-remote-mcp

前提条件

このサーバーはクライアントであり、サービスではありません。DataCoreのエンドポイントと、呼び出しに必要なmandateトークンが必要です。これらは3TITに連絡して発行を受けてください。この2つがない場合、サーバーは起動後すぐに、不足している変数を示すメッセージとともに終了します。

設定

DataCoreが発行した正しいURLをmandateとともに使用してください。別のエンドポイントではあなたのmandateは受け付けられず、401が返ります。

Claude Code / Claude Desktop

.mcp.json（プロジェクト）またはClaude Desktopの設定に追加します:

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

ツール

ツールリストはエンドポイントから生成され、ここにハードコードされていません。そのため、DataCoreがスキルを追加したら、サーバーを再起動すると新しいツールが表示されます。

デフォルトでは、実際のバックエンドに接続済みの4つのスキルを公開します:

すべてのツールは読み取り専用（readOnlyHint: true）です。書き込み、削除、作成は一切行いません。同じ入力で呼び出すと同じ結果が返ります。

DataCoreの他の3つのスキル（company.graph、company.financial-sankey、company.news）は意図的に公開されていません。これらは現在モック/決定論的データを返しています。試しに表示したい場合はDATACORE_SKILLS="*"を設定してください。ただし、結果は信用しないでください。

例

以下の3つのプロンプトは、それぞれ異なる3つのツールを実行します:

1. 住所の標準化 — 「この住所を省/県/社に標準化してください: So 1 Ly Thai To, Hoan Kiem, Ha Noi」

2. 企業検索 — 「税番号0100109106の企業情報を調べて、営業状態を教えてください」

3. Embedding — 「この業種説明のembeddingを生成して、ベクトルの次元数を教えてください: 電子機器の卸売」

セキュリティモデル

このサーバーはmandateトークンをそのままの形でX-AP2-Mandateヘッダーに載せてDataCore側で検証させ、他のauthorizationヘッダーは独自に生成しません。クライアントは自分自身に権限を付与する場所ではありません。付与されたものを転送するだけで、許可・拒否のすべての判断はDataCore側にあります。

Mandateはbearer認証情報です。保持している人は誰でも、その中のスキルを限度額まで、期限が切れるまで呼び出せます。パスワードと同じように扱ってください。トークンを入力した.mcp.jsonをコミットしないでください。また、クライアントが対応している場合は、インラインで記述する代わりにシークレットマネージャーから読み取ってください。

このパッケージは、一部であってもトークンをログに書き込むことは決してありません。送信するtextの内容も同様です。これはお使いのマシン上で実行されるプロセスに対する約束です。サービス側は別の話であり、PRIVACY.mdに何を保存するかが明記されています。

トラブルシューティング

ログはstderrに出力され、プレフィックスは[datacore-mcp]です。stdoutはJSON-RPCチャネルです。

セキュリティ脆弱性の報告

mcp-security@datacore.vn。セキュリティ脆弱性については公開issueを開かないでください。

mandateが漏洩した疑いがある場合はすぐに報告してください。期限切れを待たないでください。サービス側で対応する必要があるため、私たちに知らせてください。

プライバシー

PRIVACY.mdを参照してください。簡単に言うと、このパッケージはお使いのマシン上で実行され、何も保存せず、自分で設定したDataCoreエンドポイント以外には何も送信せず、mandateトークンをログに書き込むことは決してありません。

ライセンス

MIT — LICENSEを参照してください。