MCP Bitpanda Server

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中注册它。