使用说明

项目简介

Ntropy MCP服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在通过集成 Ntropy API 来增强银行交易数据。它提供了一系列工具，允许LLM客户端调用以创建账户持有人信息和丰富交易数据，从而为金融领域的LLM应用提供强大的数据处理能力。

主要功能点

交易数据增强: 提供 'enrich_transaction' 工具，通过调用 Ntropy API 丰富银行交易的描述信息，例如将模糊的交易记录转化为清晰的商户信息和交易类别。
账户持有者管理: 提供 'create_account_holder' 工具，允许创建和管理账户持有者信息，为后续的交易数据关联和分析提供基础。
标准化MCP接口: 遵循 MCP 协议标准，通过 JSON-RPC 协议与客户端通信，易于集成到支持 MCP 协议的 LLM 应用中。
工具注册与执行: 服务器注册了 'create_account_holder' 和 'enrich_transaction' 两个工具，LLM客户端可以调用这些工具来执行数据增强操作。

安装步骤

获取 Ntropy API Key: 访问 ntropy.com 创建账户并获取 API Key。
安装依赖: 确保已安装 'uvx' (或 'uv') 和 'requests' 库。如果使用 'uvx'，它会自动处理依赖。如果手动运行，请确保安装了 'requests'。

服务器配置

对于 MCP 客户端（例如 Claude Desktop），您需要配置服务器连接信息。以下是针对 Ntropy MCP 服务器的配置示例，您需要将其添加到客户端的 MCP 服务器配置文件中。

{
  "serverName": "ntropy-mcp",
  "command": "uvx",
  "args": [
    "ntropy-mcp",
    "--api-key",
    "YOUR_NTROPY_API_KEY" // 请替换为您的 Ntropy API Key
  ]
}

配置参数说明:

'serverName': 服务器名称，可以自定义，用于在客户端中标识该服务器，例如 "ntropy-mcp"。
'command': 启动服务器的命令，这里使用 'uvx'。如果使用其他方式运行，请根据实际情况修改，例如 'python'。
'args': 传递给启动命令的参数列表。
- '"ntropy-mcp"': 指定要运行的 'ntropy-mcp' 应用。
- '"--api-key"': 传递 Ntropy API Key 的参数名。
- '"YOUR_NTROPY_API_KEY"': 请务必替换为您的实际 Ntropy API Key。

基本使用方法

启动服务器: 根据上述服务器配置，使用 MCP 客户端启动 Ntropy MCP 服务器。服务器将会在后台运行并等待客户端请求。
客户端调用工具: 在 LLM 应用中，通过 MCP 客户端连接到 Ntropy MCP 服务器。

调用 'create_account_holder' 工具: 用于创建账户持有者，例如：

{
  "tool_call_id": "tool_call_1",
  "type": "tool_code",
  "function": {
    "name": "create_account_holder",
    "arguments": {
      "id": "用户自定义ID",
      "type": "consumer",
      "name": "账户持有者姓名"
    }
  }
}

调用 'enrich_transaction' 工具: 用于增强交易数据，例如：

{
  "tool_call_id": "tool_call_2",
  "type": "tool_code",
  "function": {
    "name": "enrich_transaction",
    "arguments": {
      "id": "交易ID",
      "description": "原始交易描述",
      "date": "交易日期 (YYYY-MM-DD)",
      "amount": 交易金额,
      "entry_type": "incoming" 或 "outgoing",
      "currency": "货币代码 (USD, EUR, etc.)",
      "account_holder_id": "账户持有者ID",
      "country": "国家代码 (可选)"
    }
  }
}

获取结果: 客户端将收到服务器返回的 JSON-RPC 响应，其中包含工具执行的结果，例如增强后的交易数据或账户持有者信息。

通过以上步骤，您可以利用 Ntropy MCP 服务器提供的工具，在 LLM 应用中实现银行交易数据的增强和账户持有者管理功能。

关键词