Servidor MCP de Monobank (Node.js/TypeScript)

Implementación en Node.js/TypeScript del Servidor MCP de Monobank escrito originalmente en Python.

El servidor MCP de Monobank expone tu cuenta personal de Monobank (y los tipos de cambio públicos) como herramientas del Protocolo de Contexto de Modelos (MCP).

Acerca de esta versión

Esta es una adaptación a Node.js/TypeScript de la implementación original en Python de @nklymok.

• Versión original en Python: https://github.com/nklymok/Monobank-MCP

• Esta versión en TypeScript: Mantiene las mismas herramientas principales para cuentas personales con las ventajas del ecosistema Node.js/TypeScript, además de una herramienta de tipos de cambio públicos que no requiere token.

Related MCP server: Monobank MCP Server

Características

• Servidor MCP en TypeScript/Node.js utilizando el SDK oficial @modelcontextprotocol/sdk

• Herramientas MCP:

  • get_client_info – identidad del cliente, cuentas y huchas (requiere MONOBANK_API_TOKEN).

  • get_statement – estado de cuenta para un período de tiempo (requiere token). Valida el período antes de llamar a la API; las respuestas utilizan importes en unidades principales y tiempos en formato ISO 8601 UTC para las transacciones.

  • get_currency_rates – tipos de cambio públicos de Monobank (GET /bank/currency). No requiere token de API.

Uso (Paquete publicado)

La forma más sencilla de utilizar este servidor MCP es a través del paquete npm publicado:

1. Registra el servidor en tu configuración de MCP

   {
     "mcpServers": {
       "monobank-mcp": {
         "command": "npx",
         "args": ["-y", "@alerix/monobank-mcp"],
         "env": {
           "MONOBANK_API_TOKEN": "your_token_here"
         }
       }
     }
   }

   Establece MONOBANK_API_TOKEN solo si utilizas get_client_info o get_statement. get_currency_rates funciona sin él.

2. Ejecuta tu cliente MCP – las herramientas estarán disponibles según tu configuración.

Desarrollo

Si deseas contribuir o modificar el servidor:

1. Clona e instala las dependencias

   git clone https://github.com/aler1x/monobank-mcp.git
   cd monobank-mcp
   npm install

2. Ejecuta el servidor después de la instalación (prepare ejecuta npm run build). Para herramientas personales, establece MONOBANK_API_TOKEN.

   Windows (PowerShell):

   $env:MONOBANK_API_TOKEN="your_token_here"
   node dist/index.js

   Windows (Símbolo del sistema):

   set MONOBANK_API_TOKEN=your_token_here
   node dist\index.js

   macOS/Linux:

   export MONOBANK_API_TOKEN=your_token_here
   node dist/index.js

   O en una sola línea:

   MONOBANK_API_TOKEN=your_token_here node dist/index.js

3. Desarrollo con recarga en caliente (utiliza tsx --watch):

   MONOBANK_API_TOKEN=your_token_here npm run dev

4. Compilación (TypeScript → dist/):

   npm run build

Referencia de herramientas

Token de API

Las herramientas personales necesitan un token de API personal de Monobank. Consulta la documentación oficial: https://api.monobank.ua/index.html

Variables de entorno

Licencia

MIT