Arca MCP Server

Сервер Model Context Protocol (MCP), реализованный на TypeScript для проекта Arca.

Структура

• src/tools/: Инструменты (tools), которые предоставляет сервер.

• src/commands/: Бизнес-логика и команды.

• src/prompts/: Шаблоны промптов и контекст.

• src/vector_store/: Логика эмбеддингов, чанкинга и персистентности с PostgreSQL и pgvector.

Related MCP server: ArcaMCP

Возможности (Capabilities)

Доступные инструменты

• query_arca_docs: Семантический поиск (RAG) в технической документации AFIP.

• get_ta: Получает и кэширует Токен доступа (Token и Sign) AFIP WSAA, используя ваш сертификат .crt и .key.

• get_ultimo_comprobante: Запрашивает последний номер авторизованного документа в AFIP для точки продажи.

• create_invoice: Создает и авторизует электронный счет-фактуру (A, B или C) напрямую в AFIP, автоматически рассчитывая суммы НДС.

Доступные ресурсы

• resource://arca/guides/wsaa: Пошаговое руководство по аутентификации AFIP.

• resource://arca/guides/invoice/{type}: Руководство по выпуску конкретных документов (A, B, C, MTXCA).

Требования

• Node.js (v18+)

• Yarn

• PostgreSQL с включенным расширением pgvector.

Установка

yarn install

Использование

Для разработки в IDE/CLI (через Stdio):

yarn dev

Локальная разработка (HTTP и MCP Inspector)

Если вы хотите протестировать сервер локально через сеть и использовать веб-инспектор для отладки инструментов, выполните следующие шаги:

1. Запустите сервер в режиме HTTP (Streamable):

   yarn run dev:http

   Сервер будет прослушивать http://localhost:3001/mcp.

2. Запустите MCP Inspector: Откройте новый терминал в проекте и выполните:

   yarn run inspect

   Это откроет окно в вашем браузере.

3. Подключите Inspector к локальному серверу: В веб-интерфейсе Inspector, если он позволяет настроить транспорт HTTP Streamable, укажите http://localhost:3001/mcp. В противном случае вы можете продолжать использовать его в стандартном режиме (Stdio), запустив Inspector с указанием локального index напрямую (npx @modelcontextprotocol/inspector node dist/index.js). Нажмите "Connect", и вы увидите список всех инструментов (tools), предоставляемых сервером, готовых к тестированию.

Для компиляции и запуска в продакшене:

yarn build
yarn start