ntropy-mcp MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Supports enrichment of Amazon transactions, identifying and categorizing Amazon purchase data in banking records.

  • Supports enrichment of Netflix subscription transactions, identifying and categorizing streaming service payments in banking records.

  • Supports enrichment of Starbucks purchase transactions, identifying and categorizing coffee shop expenditures in banking records.

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 (字符串/整数)、 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 配置文件通常位于:

在 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 .

贡献

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

执照

ntropy-mcp 采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件,但需遵守 MIT 许可证的条款和条件。更多详细信息,请参阅项目仓库中的 LICENSE 文件。

-
security - not tested
A
license - permissive license
-
quality - not tested

通过 Ntropy API 丰富银行数据,提供创建账户持有人和有效丰富交易的工具。

  1. Components
    1. Tools
  2. Quickstart
    1. Install
  3. Example Usage
    1. Check Connection
    2. Create and Update Account Holders
    3. Enrich Transactions
  4. Debugging
    1. Build
      1. Contributing
        1. License
          ID: m67bltwfhr