AI导哈

加密货币交易AI助手

3Commas MCP Server是一个集成AI助手与3Commas加密货币交易平台API的模型上下文协议服务器，通过自然语言对话管理DCA机器人和交易策略。

  • by severity1
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 severity1/3commas-mcp

使用说明

3命令MCP服务器

模型上下文协议（MCP）服务器，将人工智能助手与3Commas加密货币交易平台API集成。通过与任何MCP支持平台（包括Claude、Claude Code CLI、Claude Desktop、Cursor和Copilot Studio）的自然对话来管理您的DCA机器人和交易策略。

可用工具

账户管理✅

  • health_check() -测试API连接和身份验证状态
  • get_account_info(account_id) -获取账户详细信息、余额、利润指标（摘要或特定账户）
  • get_connected_exchanges_and_wallets() -查看所有已连接的交易所的权限和状态
  • get_balance_history_data(date_from, account_id) -历史余额变化与利润跟踪

市场数据✅

  • get_supported_markets() -列出支持的交易市场和交易所
  • get_all_market_pairs(market_code) -获取任何交易所的可用交易对
  • get_currency_rates_and_limits(market_code, pair) -货币对的当前汇率、限额和精度

DCA机器人管理✅

  • get_dca_bot_list() -获取所有DCA机器人的状态、配置和性能概述
  • get_dca_bot_details(bot_id) -全面的机器人配置、交易和性能数据
  • get_available_strategy_list() -具有配置选项的可用DCA机器人交易策略
  • get_dca_bot_profit_data(bot_id) -每日利润分析，包括BTC/USD金额和时间戳
  • get_blacklist_of_pairs() -获取带有限制和配置的黑名单交易对

实施状态29个计划中的GET API中有10个已完成（34.5%）- 只读操作仅用于交易安全

所有工具包括 response_filter 参数("display" 对于基本数据， "full" 完整响应）。

看 文档/工具/ 详细的功能文档和 docs/API_REFERENCES.md文件 获取完整的API状态。

安装和设置

先决条件

  • Python 3.12+
  • uv 包管理器（推荐）或 pip
  • 3具有API访问权限的通用帐户

安装

git clone https://github.com/your-username/3commas-mcp.git
cd 3commas-mcp

# Setup environment
uv venv && source .venv/bin/activate
uv sync && uv pip install -e .

配置Claude代码CLI

claude mcp add -e 3COMMAS_API_KEY=your_api_key -e 3COMMAS_SECRET_KEY=your_secret_key -e 3COMMAS_ENABLE_DESTRUCTIVE=false -s user threecommas-mcp -- "threecommas-mcp"

为Claude桌面配置

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "threecommas-mcp": {
      "command": "/path/to/uv",
      "args": ["--directory", "/path/to/3commas-mcp", "run", "threecommas-mcp"],
      "env": {
        "3COMMAS_API_KEY": "your_api_key",
        "3COMMAS_SECRET_KEY": "your_secret_key", 
        "3COMMAS_ENABLE_DESTRUCTIVE": "false"
      }
    }
  }
}

配置文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

使用示例

"Show me all my connected exchanges and their status"
"List all my DCA bots and their current status"
"What trading pairs are available on Binance?"

看 文档/对话/ 了解全面的使用示例和场景。

架构与安全

只读操作 -目前的实现具有安全的HMAC-SHA256身份验证和全面的错误处理，交易风险为零。

看 docs/DEVELOPMENT.md 了解技术架构和安全细节。

发展

# Run quality checks
uv run -m black . && uv run -m ruff format . && uv run -m ruff check . && uv run -m mypy .

看 docs/CONTRIBUTING.md 供款指南和 docs/DEVELOPMENT.md 有关设置的详细信息。

文档

许可与免责声明

MIT许可证-有关详细信息，请参阅许可证文件。

交易免责声明：此软件用于教育目的。加密货币交易涉及重大风险。始终仔细审查配置，永远不要交易超过你能承受的损失。作者不对交易损失负责。

支持

内置于 FastMCP 以及全面的安全第一设计模式。

相关 MCP