DataCore A2A — MCP 서버

MCP 클라이언트(Claude Code, Claude Desktop, VS Code, Cursor…)가 DataCore의 데이터 스킬을 네이티브 도구처럼 사용할 수 있게 합니다: 베트남 주소 표준화, 주소 확인, 기업 조회, 임베딩 생성.

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에 문의하여 발급받으세요. 이 두 가지가 없으면 서버는 시작 후 누락된 변수 안내와 함께 즉시 종료됩니다.

구성

발급된 mandate와 함께 제공된 정확한 DataCore URL을 사용하세요. 다른 엔드포인트는 귀하의 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의 다른 세 가지 스킬(company.graph, company.financial-sankey, company.news)은 의도적으로 노출되지 않습니다: 현재 mock/결정적 데이터를 반환하고 있습니다. 테스트를 위해 보려면 DATACORE_SKILLS="*"를 설정하고 결과를 신뢰하지 마세요.

예시

아래 세 가지 프롬프트는 서로 다른 세 가지 도구를 통해 실행됩니다:

1. 주소 표준화 — "이 주소를 성/군/면으로 표준화: So 1 Ly Thai To, Hoan Kiem, Ha Noi"

2. 기업 조회 — "세금 코드 0100109106인 기업 정보를 찾고 활동 상태를 알려주세요"

3. 임베딩 — "이 업종 설명에 대한 임베딩을 생성하고 벡터가 몇 차원인지 알려주세요: 전자 기기 도매"

보안 모델

이 서버는 mandate 토큰을 원문 그대로 X-AP2-Mandate 헤더에 담아 DataCore 측에서 검증하도록 하며, 다른 authorization 헤더를 자체적으로 선언하지 않습니다. 클라이언트는 스스로에게 권한을 부여하는 곳이 아닙니다 — 발급받은 것을 전달할 뿐이며, 허용 또는 거부에 대한 모든 결정은 DataCore 측에 있습니다.

Mandate는 bearer 자격 증명입니다: 이를 보유한 사람은 누구나 해당 스킬을 한도가 소진될 때까지, 만료될 때까지 호출할 수 있습니다. 비밀번호처럼 취급하세요 — 토큰이 채워진 .mcp.json을 커밋하지 말고, 클라이언트가 지원한다면 인라인 대신 시크릿 관리자에서 읽으세요.

이 패키지는 토큰을 로그에 기록하지 않습니다. 일부라도 마찬가지입니다. 귀하가 보낸 text 내용도 기록하지 않습니다. 이는 귀하의 머신에서 실행되는 프로세스에 대한 약속입니다 — 서비스 측은 별개의 문제이며, PRIVACY.md에 무엇을 저장하는지 명시되어 있습니다.

문제 해결

로그는 stderr로 출력되며 [datacore-mcp] 접두사가 붙습니다. stdout은 JSON-RPC 채널입니다.

보안 취약점 신고

mcp-security@datacore.vn. 보안 취약점에 대해 공개 이슈를 열지 마세요.

자신의 mandate가 유출되었다고 의심되면 즉시 신고하세요 — 만료될 때까지 기다리지 마세요. 서비스 측에서 처리할 수 있도록 알아야 합니다.

개인정보 보호

PRIVACY.md를 참조하세요. 요약: 이 패키지는 귀하의 머신에서 실행되며, 아무것도 저장하지 않고, 귀하가 직접 구성한 DataCore 엔드포인트 외에는 어디로도 전송하지 않으며, mandate 토큰을 로그에 기록하지 않습니다.

라이선스

MIT — LICENSE 참조.