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, чтобы их получить. Без этих двух вещей сервер запускается и сразу завершается с сообщением о том, какой переменной не хватает.

Конфигурация

Используйте именно тот URL DataCore, который выдан вместе с 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 (company.graph, company.financial-sankey, company.news) намеренно не доступны: они возвращают mock/детерминированные данные. Чтобы увидеть их для тестирования, установите DATACORE_SKILLS="*", но не доверяйте результатам.

Примеры

Три приведённых ниже промпта работают через три разных инструмента:

1. Нормализация адреса — «Нормализуй этот адрес до провинции/района/коммуны: So 1 Ly Thai To, Hoan Kiem, Ha Noi»

2. Поиск компании — «Найди информацию о компании с ИНН 0100109106 и сообщи мне статус её деятельности»

3. Эмбеддинг — «Сгенерируй эмбеддинг для этого описания отрасли и скажи, сколько измерений в векторе: bán buôn thiết bị điện tử»

Модель безопасности

Этот сервер передаёт mandate-токен в исходном виде в заголовке X-AP2-Mandate для проверки на стороне DataCore и сам не добавляет никаких других заголовков авторизации. Клиент не должен быть местом, где выдаются права самому себе — он лишь передаёт то, что ему выдано, а все решения о разрешении или отказе принимаются на стороне 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.