Arca MCP 服务器

为 Arca 项目实现的 模型上下文协议（MCP） 服务器，使用 TypeScript。

结构

• src/tools/：服务器暴露的工具。

• src/commands/：业务逻辑和命令。

• src/prompts/：提示词模板和上下文。

• src/vector_store/：嵌入、分块以及使用 PostgreSQL 和 pgvector 进行持久化的逻辑。

Related MCP server: ArcaMCP

能力

可用工具

• query_arca_docs：在 AFIP 技术文档中进行语义搜索（RAG）。

• get_ta：使用您的 .crt 和 .key 证书获取并缓存 AFIP WSAA 的访问票据（Token 和 Sign）。

• get_ultimo_comprobante：查询 AFIP 中某个销售点已授权的最后一张凭证编号。

• create_invoice：直接在 AFIP 中生成并授权电子发票（A、B 或 C 类），自动计算增值税金额。

可用资源

• resource://arca/guides/wsaa：AFIP 认证的分步指南。

• resource://arca/guides/invoice/{type}：特定凭证（A、B、C、MTXCA）的签发指南。

要求

• Node.js（v18+）

• Yarn

• 启用了 pgvector 扩展的 PostgreSQL。

安装

yarn install

使用

用于 IDE/CLI 开发（通过 Stdio）：

yarn dev

本地开发（HTTP 和 MCP Inspector）

如果您希望通过网络在本地测试服务器，并使用 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。否则，您可以通过直接指向本地 index 来以标准模式（Stdio）使用它（运行 npx @modelcontextprotocol/inspector node dist/index.js）。 点击 "Connect"，您将看到服务器暴露的所有工具已列出，可供测试。

编译并运行于生产环境：

yarn build
yarn start