Arca MCP Server

Model Context Protocol (MCP) Server, implementiert in TypeScript für das Arca-Projekt.

Struktur

• src/tools/: Tools, die der Server bereitstellt.

• src/commands/: Geschäftslogik und Befehle.

• src/prompts/: Prompt-Vorlagen und Kontext.

• src/vector_store/: Logik für Embedding, Chunking und Persistenz mit PostgreSQL und pgvector.

Related MCP server: ArcaMCP

Fähigkeiten (Capabilities)

Verfügbare Tools

• query_arca_docs: Semantische Suche (RAG) in der technischen Dokumentation von AFIP.

• get_ta: Holt und cached das Zugangsticket (Token und Sign) von AFIP WSAA unter Verwendung Ihres .crt- und .key-Zertifikats.

• get_ultimo_comprobante: Fragt die letzte autorisierte Belegnummer bei AFIP für eine Verkaufsstelle ab.

• create_invoice: Erstellt und autorisiert eine elektronische Rechnung (A, B oder C) direkt bei AFIP, mit automatischer Berechnung der Mehrwertsteuerbeträge.

Verfügbare Resources

• resource://arca/guides/wsaa: Schritt-für-Schritt-Anleitung zur AFIP-Authentifizierung.

• resource://arca/guides/invoice/{type}: Anleitung zur Ausstellung spezifischer Belege (A, B, C, MTXCA).

Voraussetzungen

• Node.js (v18+)

• Yarn

• PostgreSQL mit aktivierter pgvector-Erweiterung.

Installation

yarn install

Verwendung

Für die Entwicklung in IDEs/CLI (über Stdio):

yarn dev

Lokale Entwicklung (HTTP und MCP Inspector)

Wenn Sie den Server lokal über das Netzwerk testen und den Inspector-Webbrowser zum Debuggen der Tools verwenden möchten, gehen Sie wie folgt vor:

1. Starten Sie den Server im HTTP-Modus (Streamable):

   yarn run dev:http

   Der Server hört dann auf http://localhost:3001/mcp.

2. Starten Sie den MCP Inspector: Öffnen Sie ein neues Terminal im Projekt und führen Sie aus:

   yarn run inspect

   Dadurch öffnet sich ein Fenster in Ihrem Browser.

3. Verbinden Sie den Inspector mit dem lokalen Server: Wenn die Weboberfläche des Inspectors die Konfiguration des HTTP Streamable-Transports erlaubt, geben Sie http://localhost:3001/mcp an. Andernfalls können Sie den Inspector weiterhin im Standardmodus (Stdio) verwenden, indem Sie ihn direkt auf das lokale Index verweisen (npx @modelcontextprotocol/inspector node dist/index.js). Klicken Sie auf "Connect" – alle vom Server bereitgestellten Tools werden aufgelistet und können getestet werden.

Zum Kompilieren und Ausführen in der Produktion:

yarn build
yarn start