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

Related MCP server: Qonto MCP Server

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

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

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:

  "mcpServers": {
    "ntropy-mcp": {
      "command": "uvx",
      "args": [
        "ntropy-mcp",
        "--api-key",
        "YOUR_NTROPY_API_KEY"
      ]
    }
  }

y lo siguiente si usas Docker:

"mcpServers": {
  "ntropy-mcp": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "ntropy-mcp"
      "--api-key",
      "YOUR_NTROPY_API_KEY"
    ]
  }
}

Ejemplo de uso

Comprobar conexión

# Check if your API key is valid and the Ntropy API is accessible
connection_status = check_connection()
print(connection_status)

Crear y actualizar titulares de cuentas

# Create a new account holder
account_holder = create_account_holder(
    id="user123",
    type="individual",
    name="John Doe"
)

# Update an existing account holder
updated_account = update_account_holder(
    id="user123",
    name="John Smith"
)

Enriquecer transacciones

# Enrich a single transaction
enriched_transaction = enrich_transaction(
    id="tx123",
    description="AMAZON.COM*MK1AB6TE1",
    date="2023-05-15",
    amount=-29.99,
    entry_type="debit",
    currency="USD",
    account_holder_id="user123",
    country="US"
)

# Bulk enrich multiple transactions
transactions = [
    {
        "id": "tx124",
        "description": "NETFLIX.COM",
        "date": "2023-05-16",
        "amount": -13.99,
        "entry_type": "debit",
        "currency": "USD",
        "account_holder_id": "user123"
    },
    {
        "id": "tx125",
        "description": "Starbucks Coffee",
        "date": "2023-05-17",
        "amount": -5.65,
        "entry_type": "debit",
        "currency": "USD",
        "account_holder_id": "user123"
    }
]
enriched_transactions = bulk_enrich_transactions(transactions)

Depuración

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

npx @modelcontextprotocol/inspector uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

Construir

Compilación de Docker:

docker build -t ntropy-mcp .

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.