AI导哈

银行数据增强服务

Ntropy MCP服务器通过API为银行数据提供增强功能，支持LLM代理处理金融数据。

  • by ntropy-network
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 ntropy-network/ntropy-mcp

使用说明

Ntropy MCP服务器

MCP服务器，用于使用Ntropy API丰富银行数据。这允许使用财务数据的LLM代理轻松调用任何Ntropy API端点。

组件

工具

服务器实现以下工具以与Ntropy API交互：

  • check_connection：验证与Ntropy API的连接

    • 返回：连接状态信息

  • set_api_key：在运行时设置或更新Ntropy API密钥

    • 参数： api_key （字符串）
    • 返回：API密钥更新和验证的状态

  • create_account_holder：创建帐户持有人

    • 参数： id （字符串/int）， type （字符串）， name （字符串）
    • 返回：创建的账户持有人详细信息

  • update_account_holder：更新现有帐户持有人

    • 参数： id （字符串/int）， name （字符串，可选）， type （字符串，可选）
    • 返回：更新的账户持有人详细信息

  • 富集交易：丰富银行交易

    • 参数： id （字符串/int）， description （字符串）， date （字符串）， amount （浮动）， entry_type （字符串）， currency （字符串）， account_holder_id （字符串/int）， country （字符串，可选）
    • 返回：丰富的交易数据

  • get_count_holder：获取账户持有人的详细信息

    • 参数： account_holder_id （字符串/int）
    • 退货：账户持有人详细信息

  • list_交易：列出账户持有人的交易记录

    • 参数： account_holder_id （字符串/int）， limit （int，默认值=10）， offset （int，默认值=0）
    • 返回：交易列表

  • get_transaction：获取特定交易的详细信息

    • 参数： transaction_id （字符串/int）
    • 返回：交易详情

  • 大宗交易：同时丰富多个交易

    • 参数： transactions （交易对象列表）
    • 返回：丰富交易列表

  • delete_account_holder：删除账户持有人和所有相关数据

    • 参数： account_holder_id （字符串/int）
    • 返回：删除状态

  • 删除交易：删除特定交易

    • 参数： transaction_id （字符串/int）
    • 返回：删除状态

快速启动

安装

首先，通过在上创建帐户来获取您的Ntropy API密钥 ntropy.com.确保更换 YOUR_NTROPY_API_KEY 下面是您的实际API密钥。

使用uvx运行服务器

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

克劳德桌面

Claude Desktop配置文件通常位于：

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json

在Windows上： %APPDATA%/Claude/claude_desktop_config.json

如果使用uvx，请将以下内容添加到配置文件中：

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

如果使用docker，则如下：

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

示例用法

检查连接

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

创建和更新帐户持有人

# 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"
)

丰富交易

# 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)

调试

您可以使用MCP检查器调试服务器。对于uvx安装：

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

构建

Docker构建：

docker build -t ntropy-mcp .

贡献

欢迎拉取请求！请随时贡献新想法、错误修复或增强功能。

许可证

ntropy mcp根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP