Ntropy

🚀 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 文件。