MCP Bitpanda 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Bitpanda API 交互的工具。该服务器允许通过 MCP 协议以编程方式访问 Bitpanda 的功能，例如交易、钱包和交易记录。

先决条件

• Node.js（建议使用 v18 或更高版本）

• npm（Node.js 附带）

• Bitpanda API 密钥（设置为BITPANDA_API_KEY环境变量）

• （可选）兼容 MCP 的客户端或运行器（例如 VSCode 扩展、CLI）

设置

1. 克隆存储库或确保您位于项目目录中。

2. 安装依赖项：

   npm install

3. 构建服务器：

   npm run build

   这将创建一个包含已编译 JavaScript 代码的build目录。

运行服务器

• 直接地：

  node build/index.js

  或者，如果你有一个启动脚本：

  npm run start

• **通过 MCP 运行器：**配置您的 MCP 客户端，使用 stdio 传输运行服务器。MCP 设置条目示例：

  "mcp-bitpanda": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-bitpanda/build/index.js" ] // Add environment variables, e.g., for the API key "environmentVariables": { "BITPANDA_API_KEY": "YOUR_BITPANDA_API_KEY" // Replace with your actual API key or use a secure method to provide it } // ... other optional settings ... }

可用工具

• get_asset_info ：通过特定资产的符号（例如 BTC、XAU）检索其详细信息。

  • 参数： symbol （字符串，必需）

  • 注意：此工具不需要 API 密钥。

• get_ohlc ：检索特定资产、法定货币和时间范围的 OHLC（开盘价/最高价/最低价/收盘价）数据。

  • 参数：

    • symbol （字符串，必需）：交易符号。

    • fiatCurrency （字符串，必需）：法定货币（例如，美元、欧元）。

    • timeframe （字符串，必需）：“天”或“周”。

  • 注意：此工具不需要 API 密钥。

• list_trades ：列出所有用户通过 Bitpanda API 进行的交易。最新交易优先。响应按游标分页显示。

  • 参数：

    • type （字符串，可选）： buy或sell之一。

    • cursor （字符串，可选）：客户端已知的最后一笔交易的 ID。仅返回此 ID 之后的交易。cursor 参数为空或缺失时，将从头开始返回交易。

    • page_size （整数，可选）：分页响应的页面大小。

• list_asset_wallets ：列出 Bitpanda API 中按资产类型分组的所有用户资产钱包。

  • 参数：无。

• list_fiat_wallets ：列出来自 Bitpanda API 的所有用户的法定钱包。

  • 参数：无。

• list_fiat_transactions ：列出用户通过 Bitpanda API 进行的所有法币交易。最新的法币交易优先。响应按游标分页显示。

  • 参数：

    • type （字符串，可选）：购买、出售、存款、取款、转账、退款。

    • status （字符串，可选）：待定、处理中、完成、取消。

    • cursor （字符串，可选）：客户端已知的最后一笔法币交易的 ID。仅返回此 ID 之后的法币交易。cursor 参数为空或缺失时，将从头开始返回法币交易。

    • page_size （整数，可选）：分页响应的页面大小。

• list_crypto_wallets ：列出来自 Bitpanda API 的所有用户的加密钱包。

  • 参数：无。

• list_crypto_transactions ：列出用户通过 Bitpanda API 发起的所有加密交易。最新的加密交易优先。响应以游标分页形式呈现。

  • 参数：

    • type （字符串，可选）： buy 、 sell 、 deposit 、 withdrawal 、 transfer 、 refund或ico之一。

    • status （字符串，可选）： pending处理、 processing 、 unconfirmed_transaction_out交易、 open_invitation 、 finished或canceled之一。

    • cursor （字符串，可选）：客户端已知的最后一笔加密交易的 ID。仅返回此 ID 之后的加密交易。cursor 参数为空或缺失将从头开始返回加密交易。

    • page_size （整数，可选）：分页响应的页面大小。

• list_commodity_transactions ：列出用户通过 Bitpanda API 进行的所有商品交易。最新商品交易优先。响应以游标分页形式呈现。

  • 参数：

    • cursor （字符串，可选）：客户端已知的最后一笔商品交易的 ID。仅返回此 ID 之后的商品交易。cursor 参数为空或缺失时，将从头开始返回商品交易。

    • page_size （整数，可选）：分页响应的页面大小。

扩展

要添加更多 Bitpanda API 端点作为工具，请在src/tools/中实现一个新的工具文件，并在src/tools/index.ts中注册它。