AI导哈

加密货币交易机器人

一个支持多交易所、AI决策引擎和风险管理的加密货币交易自动化工具。

  • by cryptomcp
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cryptomcp/crypto-mcp-server

使用说明

MCP加密机器人（Python）

支持人工智能决策的加密交易自动化生产就绪模型上下文协议（MCP）服务器。

🚀 特性

核心功能

  • 多交换支持：CEX（币安等）、EVM链、Solana
  • AI决策引擎：OpenAI GPT-4、谷歌Gemini、DeepSeek集成
  • 电报机器人：实时管理和通知
  • 风险管理：可配置的限制和安全检查
  • 钱包管理：EVM和Solana钱包创建/导入/导出
  • 投资组合跟踪：实时平衡和位置监控

交易特点

  • CEX交易：现货订单、OHLCV数据、余额管理
  • DEX集成：EVM上的0x互换，Solana上的Jupiter互换
  • 代币转移：ERC20和SPL代币转移
  • AI交易助理：具有风险评估的智能交易建议
  • 新闻交易：实时新闻监控、情绪分析和人工智能驱动的交易决策

📋 需求

  • Python 3.11+
  • Linux/macOS/Windows
  • 用于交易所和人工智能提供商的API密钥

🛠️ 安装

选项1：单层安装（推荐）

# Install with pipx (isolated environment)
pipx install mcp-crypto-bot

# Or with uv (fast package manager)
uvx install mcp-crypto-bot

# Run from anywhere
mcp-crypto-bot

选项2：手动安装

# Clone repository
git clone https://github.com/cryptomcp/crypto-ai-mcp-server.git
cd crypto-ai-mcp-server

# Install in development mode
pip install -e .

# Or using uv (recommended)
uv pip install -e .

环境配置

cp .env.example .env
# Edit .env with your API keys and settings

🚀 用法

快速开始

# Start the MCP server
mcp-crypto-bot

# Or with custom environment
TELEGRAM_BOT_TOKEN=your_token mcp-crypto-bot

MCP检查器集成

# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Run with Inspector
npx @modelcontextprotocol/inspector -- mcp-crypto-bot

# With environment injection
npx @modelcontextprotocol/inspector --env-file .env -- mcp-crypto-bot

🛠️ MCP工具和资源

可用工具

  • CEX交易：价格检查、订单下达、余额管理
  • EVM运营：代币转移、DEX掉期、NFT操作
  • Solana支持：SPL代币转账、Jupiter掉期、钱包管理
  • AI决策引擎：智能交易建议
  • 投资组合管理：余额跟踪和投资组合快照
  • 新闻交易：新闻监控、情绪分析、趋势分析、自定义条件

可用资源

  • resource: wallets：列出当前的EVM和Solana钱包
  • resource: candles://{venue}/{symbol}/{timeframe}：实时OHLCV数据

新闻交易功能

  • 实时新闻监控：RSS提要、API、来自多个来源的网络抓取
  • 情感分析：使用OpenAI、Gemini和TextBlob进行人工智能情绪分析
  • 自定义交易条件：基于规则的交易，包括情绪、频率、关键字和趋势条件
  • 趋势分析：多平台趋势硬币检测和排名
  • 人工智能决策：基于新闻和市场数据的智能交易决策
  • 风险管理：头寸大小、止损、止盈和每日限额
  • 交易模式：手动、人工智能辅助和全自动交易

示例用法

from mcp import ClientSession

async with ClientSession() as session:
    # Get wallet information
    wallets = await session.read_resource("resource: wallets")
    
    # Get market data
    candles = await session.read_resource("resource: candles://binance/BTC/USDT/1h")
    
    # Execute trading operations
    result = await session.call_tool("cex_get_price", {"symbol": "BTC/USDT"})

⚙️ 配置

环境变量

变量 描述 必填 默认
LIVE 启用实时交易（0=测试，1=实时） 是 0
AM_I_SURE 实时交易安全确认 是 NO
MAX_ORDER_USD 最大订单金额（美元） 是 100
DAILY_LOSS_LIMIT_USD 每日损失限额（美元） 是 200
TELEGRAM_BOT_TOKEN Telegram机器人令牌 否 -
OWNER_TELEGRAM_ID 您的Telegram用户ID 否 -
OPENAI_API_KEY 人工智能决策的OpenAI API密钥 否 -
GOOGLE_API_KEY Google AI API密钥 否 -
DEEPSEEK_API_KEY DeepSeek API密钥 否 -
BINANCE_API_KEY 币安API密钥 否 -
BINANCE_SECRET 币安密钥 否 -
ETHEREUM_RPC_URL 以太坊RPC端点 否 -
SOLANA_RPC_URL Solana RPC终结点 否 -

安全配置

# Test mode (safe)
LIVE=0
AM_I_SURE=NO
MAX_ORDER_USD=100
DAILY_LOSS_LIMIT_USD=200

# Live trading (dangerous - only if you know what you're doing)
LIVE=1
AM_I_SURE=YES
MAX_ORDER_USD=1000
DAILY_LOSS_LIMIT_USD=1000

📚 文档

查看完整文档 docs.cryptomcp.github.io

🏃‍♂️ 在本地运行文档

# 1. Navigate to docs directory
cd docs

# 2. Install dependencies
npm install

# 3. Start development server
npm run start

# 4. Open browser to http://localhost:3000

🏗️ 建筑文件

# Build for production
npm run build

# Serve built documentation locally
npm run serve

🚀 部署到GitHub页面

# Deploy to GitHub Pages
npm run deploy

# Documentation will be available at:
# https://cryptomcp.github.io/crypto-ai-mcp-server/

⚠️ 风险管理

安全功能

  • 双重确认: LIVE=1 与 AM_I_SURE=YES 必需的
  • 订单限制: MAX_ORDER_USD 强制执行最大交易规模
  • 损失限额: DAILY_LOSS_LIMIT_USD 防止过度损失
  • 干运行模式：测试所有操作 dry_run: true
  • 风险评估：AI评估所有交易建议

关键安全规则

  1. 从不 集 LIVE=1 没有 AM_I_SURE=YES
  2. 总是 测试与 dry_run: true 第一
  3. 监视器 每日损失限额
  4. 备份 安全的钱包私钥
  5. 从小做起：从少量开始

🧪 测试

单元测试

pytest tests/

集成测试

pytest tests/ -m integration

手动测试

# Start server in test mode
LIVE=0 python src/server.py

# Use MCP inspector
npx @modelcontextprotocol/inspector -- python src/server.py

🏗️ 建筑

src/
├── server.py              # MCP server bootstrap
├── mcp_tools.py           # All MCP tool definitions
├── config/
│   └── env.py            # Environment configuration
├── cex/
│   └── ccxt_client.py    # CEX trading client
├── evm/
│   └── evm_client.py     # EVM blockchain client
├── solana/
│   └── solana_client.py  # Solana blockchain client
├── wallets/              # Wallet management
├── portfolio/            # Portfolio tracking
├── ai/                   # AI decision engine
│   ├── engine.py
│   └── prompts.py
├── telegram/
│   └── bot.py           # Telegram bot
└── logging.py           # Logging configuration

🔧 发展

添加新工具

  1. 在中定义Pydantic模型 mcp_tools.py
  2. 使用以下工具实现工具功能 @mcp.tool() 装饰器
  3. 添加错误处理和日志记录
  4. 更新测试

添加新的AI提供商

  1. 将提供者添加到 AIProvider 枚举
  2. 在中实现查询方法 AIDecisionEngine
  3. 如果需要，添加到集成逻辑中
  4. 更新配置

📝 api参考

响应格式

所有工具都返回结构化JSON：

{
  "success": true|false,
  "data": { ... } | null,
  "error": "error message" | null
}

错误处理

  • 网络错误会自动重试
  • 验证错误返回描述性消息
  • 违反风险会妨碍执行
  • 所有错误都会与上下文一起记录

🤝 贡献

  1. 分叉存储库
  2. 创建特征分支
  3. 添加新功能的测试
  4. 确保所有测试通过
  5. 提交拉取请求

24/7实时支持

我们提供 24/7实时支持 有保证 即时响应 所有的请求。

  • 所有请求均在 5分钟.
  • 支持可用 每周7天，每天24小时 没有中断。
  • 解决时间可能因问题类型而异，但初始响应总是即时的。
  • 我们提供 多语言支持，但我们 主要语言是英语.

联系我们

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

⚠️ 免责声明

此软件仅用于教育和研究目的。加密货币交易涉及巨大的损失风险，并不适合每个投资者。过去的表现并不能保证未来的结果。你不应该用你输不起的钱交易。

本项目的作者和贡献者不对使用本软件造成的任何经济损失负责。

相关 MCP