M8ven Live Monitored

Arca MCP Server

Servidor Model Context Protocol (MCP) implementado en TypeScript para el proyecto Arca.

Estructura

src/tools/: Herramientas (tools) que expone el servidor.
src/commands/: Lógica de negocio y comandos.
src/prompts/: Plantillas de prompts y contexto.
src/vector_store/: Lógica de embedding, chunking y persistencia con PostgreSQL y pgvector.

query_arca_docs: Búsqueda semántica (RAG) en la documentación técnica de AFIP.
get_ta: Obtiene y cachea el Ticket de Acceso (Token y Sign) de AFIP WSAA usando tu certificado .crt y .key.
get_ultimo_comprobante: Consulta el último número de comprobante autorizado en AFIP para un punto de venta.
create_invoice: Genera y autoriza una factura electrónica (A, B o C) directamente en AFIP, autocalculando los importes de IVA.

resource://arca/guides/wsaa: Guía paso a paso para la autenticación AFIP.
resource://arca/guides/invoice/{type}: Guía de emisión de comprobantes específicos (A, B, C, MTXCA).

yarn install

Para desarrollo en IDEs/CLI (vía Stdio):

yarn dev

Si deseas probar el servidor localmente a través de la red y utilizar el Inspector web para depurar las tools, sigue estos pasos:

Inicia el servidor en modo HTTP (Streamable):
```
yarn run dev:http
```
El servidor quedará escuchando en http://localhost:3001/mcp.
Inicia el MCP Inspector: Abre una nueva terminal en el proyecto y ejecuta:
```
yarn run inspect
```
Esto abrirá una ventana en tu navegador.
Conecta el Inspector al servidor local: En la interfaz web del Inspector, si te permite configurar el transporte HTTP Streamable, apúntalo a http://localhost:3001/mcp. De lo contrario, puedes seguir usándolo en modo estándar (Stdio) ejecutando el Inspector apuntando al index local directamente (npx @modelcontextprotocol/inspector node dist/index.js). Haz clic en "Connect" y verás listadas todas las herramientas (tools) expuestas por el servidor listas para ser probadas.

Para compilar y ejecutar en producción:

yarn build
yarn start