🚀 Ntropy MCP 服务器

Ntropy MCP 服务器用于丰富银行数据，借助它，处理财务数据的 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）为可选参数，返回交易列表。
• bulk_enrich_transactions：批量丰富多个交易，传入包含交易对象的数组作为参数，每个交易对象需包含 id（交易 ID，字符串/整数）、description（交易描述，字符串）、date（交易日期，字符串）、amount（交易金额，浮点数）、entry_type（入账类型，字符串）、currency（货币代码，字符串）、account_holder_id（账户持有人 ID，字符串/整数），返回丰富后的交易对象数组。

📦 安装指南

使用 npm 进行安装，命令如下：

npm install @modelcontextprotocol/mcp-server

💻 使用示例

基础用法

创建一个 MCP 服务器实例并设置 API 密钥：

const { MCPServer } = require('@modelcontextprotocol/mcp-server');
const server = new MCPServer({
  apiKey: 'your_api_key_here',
});
server.listen(3000);

高级用法

使用工具进行操作：

• 创建账户持有人：

await server.createAccountHolder({
  id: "1",
  type: "personal",
  name: "John Doe"
});

• 更新账户持有人信息：

await server.updateAccountHolder({
  id: "1",
  name: "Jane Smith"
});

• 丰富交易数据：

await server.enrichTransaction({
  id: "tx123",
  description: "Grocery Shopping",
  date: "2024-01-01",
  amount: -50.0,
  entry_type: "debit",
  currency: "USD",
  account_holder_id: "1"
});

📚 详细文档

调试

你可以使用 MCP 检查器来调试服务器。对于 npm 安装，使用以下命令：

npx @modelcontextprotocol/inspector MCPServer -p 3000

构建

使用 Docker 进行构建，命令如下：

docker build -t ntropy-mcp .

贡献

欢迎提交拉取请求！ 无论是新想法、错误修复还是功能增强，都非常欢迎大家贡献力量。

📄 许可证

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