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: Alchemy MCP Plugin

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.