Ntropy MCP server

Ntropy MCP 服务

用于通过 Ntropy API 丰富银行数据的 MCP 服务。这使处理金融数据的 LLM Agent 能够轻松调用 Ntropy API 的任意端点。

组件

工具

该服务实现了以下工具，用于与 Ntropy API 交互：

• check_connection：验证与 Ntropy API 的连接

  • 返回：连接状态信息

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

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

• create_account_holder：创建账户持有人

  • 参数：id（字符串/整数）、type（字符串）、name（字符串）
  • 返回：已创建的账户持有人详情

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

  • 参数：id（字符串/整数）、name（字符串，可选）、type（字符串，可选）
  • 返回：已更新的账户持有人详情

• enrich_transaction：丰富银行交易数据

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

• get_account_holder：获取账户持有人的详情

  • 参数：account_holder_id（字符串/整数）
  • 返回：账户持有人详情

• list_transactions：列出账户持有人的交易

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

• get_transaction：获取特定交易的详情

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

• bulk_enrich_transactions：一次丰富多笔交易

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

• delete_account_holder：删除账户持有人及其所有关联数据

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

• delete_transaction：删除特定交易

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

快速开始

安装

首先，在 ntropy.com 上创建账户，以获取 Ntropy API 密钥。请确保将下方的 YOUR_NTROPY_API_KEY 替换为实际的 API 密钥。

使用 uvx 运行服务

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

Claude Desktop

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 inspector 调试服务。对于 uvx 安装：

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

构建

Docker 构建：

docker build -t ntropy-mcp .

贡献

欢迎提交拉取请求！欢迎贡献新想法、错误修复或改进。

许可证

ntropy-mcp 根据 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。