Arca MCP Server

Model Context Protocol (MCP) サーバー。TypeScript で実装された Arca プロジェクト向けです。

構造

• src/tools/: サーバーが公開するツール。

• src/commands/: ビジネスロジックとコマンド。

• src/prompts/: プロンプトテンプレートとコンテキスト。

• src/vector_store/: 埋め込み、チャンク分割、PostgreSQL と pgvector を使用した永続化のロジック。

Related MCP server: ArcaMCP

機能 (Capabilities)

利用可能なツール

• query_arca_docs: AFIP の技術ドキュメントに対するセマンティック検索 (RAG)。

• get_ta: 証明書 .crt と .key を使用して AFIP WSAA のアクセストークン (トークンと署名) を取得しキャッシュします。

• get_ultimo_comprobante: 販売拠点に対する AFIP で承認された最後の伝票番号を照会します。

• create_invoice: AFIP で直接電子請求書 (A、B、または C) を生成および承認し、VAT 額を自動計算します。

利用可能なリソース

• 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 Web を使用してツールをデバッグする場合は、次の手順に従います。

1. HTTP (Streamable) モードでサーバーを起動:

   yarn run dev:http

   サーバーは http://localhost:3001/mcp で待機します。

2. MCP Inspector を起動: プロジェクトで新しいターミナルを開き、以下を実行します:

   yarn run inspect

   ブラウザにウィンドウが開きます。

3. Inspector をローカルサーバーに接続: Inspector の Web インターフェースで HTTP Streamable トランスポートの設定が可能な場合は、http://localhost:3001/mcp を指定します。それ以外の場合は、Inspector をローカルの index に直接向けて (npx @modelcontextprotocol/inspector node dist/index.js) 標準モード (Stdio) で引き続き使用できます。 "Connect" をクリックすると、テスト可能なサーバーが公開するすべてのツールが一覧表示されます。

本番環境向けにコンパイルして実行する場合:

yarn build
yarn start