Servidor MCP de Ntropy

Servidor MCP para enriquecer datos bancarios mediante la API de Ntropy. Esto permite a los agentes LLM que trabajan con datos financieros acceder fácilmente a cualquiera de los puntos finales de la API de Ntropy.

Componentes

Herramientas

El servidor implementa las siguientes herramientas para interactuar con la API de Ntropy:

• check_connection : verifica la conexión a la API de Ntropy

  • Devuelve: Información del estado de la conexión

• set_api_key : Establece o actualiza la clave API de Ntropy en tiempo de ejecución

  • Parámetros: api_key (cadena)

  • Devoluciones: Estado de la actualización y validación de la clave API

• create_account_holder : Crea un titular de cuenta

  • Parámetros: id (cadena/int), type (cadena), name (cadena)

  • Devoluciones: Los detalles del titular de la cuenta creada

• update_account_holder : Actualizar un titular de cuenta existente

  • Parámetros: id (cadena/int), name (cadena, opcional), type (cadena, opcional)

  • Devoluciones: Los datos actualizados del titular de la cuenta

• enrich_transaction : Enriquecer una transacción bancaria

  • Parámetros: id (cadena/int), description (cadena), date (cadena), amount (flotante), entry_type (cadena), currency (cadena), account_holder_id (cadena/int), country (cadena, opcional)

  • Devoluciones: Los datos de transacción enriquecidos

• get_account_holder : Obtener detalles del titular de una cuenta

  • Parámetros: account_holder_id (cadena/int)

  • Devoluciones: Datos del titular de la cuenta

• list_transactions : Lista las transacciones de un titular de cuenta

  • Parámetros: account_holder_id (string/int), limit (int, valor predeterminado=10), offset (int, valor predeterminado=0)

  • Devoluciones: Lista de transacciones

• get_transaction : Obtener detalles de una transacción específica

  • Parámetros: transaction_id (cadena/int)

  • Devoluciones: Detalles de la transacción

• bulk_enrich_transactions : Enriquecer múltiples transacciones a la vez

  • Parámetros: transactions (Lista de objetos de transacción)

  • Devoluciones: Lista de transacciones enriquecidas

• delete_account_holder : eliminar un titular de cuenta y todos los datos asociados

  • Parámetros: account_holder_id (cadena/int)

  • Devoluciones: Estado de eliminación

• delete_transaction : Eliminar una transacción específica

  • Parámetros: transaction_id (cadena/int)

  • Devoluciones: Estado de eliminación

Inicio rápido

Instalar

Primero, obtén tu clave API de Ntropy creando una cuenta en ntropy.com . Asegúrate de reemplazar YOUR_NTROPY_API_KEY con tu clave API.

Ejecute el servidor con uvx

Escritorio de Claude

El archivo de configuración de Claude Desktop normalmente se encuentra en:

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

Agregue lo siguiente al archivo de configuración si usa uvx:

y lo siguiente si usas Docker:

Ejemplo de uso

Comprobar conexión

Crear y actualizar titulares de cuentas

Enriquecer transacciones

Depuración

Puede usar el inspector MCP para depurar el servidor. Para instalaciones uvx:

Construir

Compilación de Docker:

Contribuyendo

¡Aceptamos solicitudes de incorporación de cambios! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras.

Licencia

ntropy-mcp está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.