🚀 Luno MCP Server - FastMCP 2.0

🚀 Luno MCP 服务 - FastMCP 2.0

这是一款面向 Luno 加密货币交易所的现代化 Model Context Protocol（MCP）服务，使用 FastMCP 2.0 和 Python 3.12 构建。

✅ 快速开始

1. 安装依赖项

# Activate the virtual environment
source venv/bin/activate

# Dependencies are already installed:
# - fastmcp 2.5.1
# - httpx
# - pydantic
# - python-dotenv

2. 配置 Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "luno": {
      "command": "/Users/aman-asmuei/Documents/mcp/mcp-luno/venv/bin/python",
      "args": [
        "/Users/aman-asmuei/Documents/mcp/mcp-luno/src/luno_mcp_server/server.py"
      ],
      "cwd": "/Users/aman-asmuei/Documents/mcp/mcp-luno",
      "env": {
        "LUNO_API_KEY": "your_api_key_here",
        "LUNO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

3. 测试

重启 Claude Desktop 并询问：

• “比特币对 EUR 的价格是多少？”
• “获取 ETHZAR 的价格”
• “显示我的账户余额”
• “获取过去 7 天 XBTZAR 的历史价格”
• “显示过去 30 天的比特币价格区间分析”

🛠️ 可用工具

公共工具（无需 API 凭据）

• get_crypto_price - 任意交易对的实时价格
• get_market_overview - 市场数据和可用交易对

历史数据工具（需要 API 凭据）

• get_historical_prices - 任意交易对的 OHLC 蜡烛图数据
• get_price_range - 指定时间段（1-30 天）的价格分析

私有工具（需要 API 凭据）

• get_account_balance - 账户余额
• place_order - 下达买入/卖出订单
• cancel_order - 取消订单
• get_order_status - 查看订单状态
• get_transaction_history - 交易历史
• get_fees - 交易手续费

📈 历史价格数据功能

蜡烛图数据（get_historical_prices）

• 时间范围： 1m、5m、15m、30m、1h、3h、4h、8h、24h、3d、7d
• 数据： OHLC（开盘价、最高价、最低价、收盘价）+ 成交量
• 限制： 每次请求最多 1000 根蜡烛
• 格式： 带时间戳的标准蜡烛图数据

价格区间分析（get_price_range）

• 周期： 1-30 天的历史数据
• 统计数据： 最高价、最低价、开盘价、收盘价、平均价格
• 指标： 价格变动、百分比变动、总成交量
• 便捷功能： 自动汇总每日蜡烛图数据

🌍 支持的交易对

• ZAR（南非）： XBTZAR、ETHZAR、ADAZAR
• EUR（欧洲）： XBTEUR、ETHEUR
• GBP（英国）： XBTGBP、ETHGBP、SOLGBP
• USD（美国）： XBTUSD、ETHUSD
• 还有更多！

🏗️ 项目结构

luno-mcp/
├── src/
│   ├── luno_mcp/              # Modern FastMCP 2.0 implementation
│   │   ├── server.py          # Main server with all tools
│   │   ├── client.py          # Luno API client
│   │   ├── config.py          # Configuration management
│   │   └── tools/             # Modular tool organization
│   ├── luno_mcp_server/       # Working FastMCP server (CURRENT)
│   │   ├── server.py          # ← Currently used by Claude Desktop
│   │   └── luno_client.py     # Luno API client
│   └── main.py                # Alternative entry point
├── tests/                     # Test suite
├── docs/                      # Documentation
├── archive/                   # Old implementations
├── venv/                      # Python 3.12 virtual environment
└── README.md                  # This file

🔧 技术详情

• Python： 3.12.10（位于虚拟环境中）
• 框架： FastMCP 2.5.1
• API 客户端： 使用 httpx 发送异步 HTTP 请求
• 传输方式： STDIO（JSON-RPC 2.0）
• 架构： 使用 Async/await，并妥善处理错误

📚 文档

• docs/PYTHON_UPGRADE_GUIDE.md - Python 升级流程
• docs/MIGRATION.md - 从旧版本迁移
• docs/CLAUDE_DESKTOP_SETUP.md - 详细设置指南
• docs/GITHUB_PAGES_FIX.md - 修复 GitHub Pages 部署错误

📚 文档站点

访问我们的 GitHub Pages 文档：https://amanasmuei.github.io/mcp-luno

注意：如果遇到 GitHub Pages 部署错误，请参阅 docs/GITHUB_PAGES_FIX.md 获取完整的修复指南。

🔒 安全

• API 凭据以环境变量形式存储
• 所有通信均使用 HTTPS
• 虚拟环境隔离
• 不会记录或泄露任何凭据

🚨 故障排除

常见问题

1. 导入错误： 请确保使用虚拟环境
2. API 错误： 检查 Luno API 凭据
3. 连接问题： 确认网络连接正常

获取帮助

1. 查看 Claude Desktop 中的日志
2. 直接测试服务：python src/luno_mcp_server/server.py
3. 验证依赖项：pip list | grep fastmcp

💖 支持此项目

如果这款 Luno MCP 服务对您的加密货币交易和分析有所帮助，欢迎支持其开发！

☕ 支持本项目

🌍 全球通用的捐赠方式：

• 💖 GitHub Sponsors： github.com/sponsors/amanasmuei (每月/一次性)
• 💳 PayPal.me： paypal.me/amanasmuei (直接付款)
• ⭐ 在 GitHub 上为此仓库点亮星标
• 🐛 报告问题并贡献改进
• 📢 与其他加密货币交易者分享

🪙 加密货币捐赠

• Bitcoin (BTC)： 3CPb1HP6Gfpx3MZFdrm4nhoHk4VbX2eZRj
• Ethereum (ETH)： 0x54dC4eDf6c940C52A1434824634d8cE8629767b3
• Luno Trading： 使用此 MCP 服务进行交易！📈

您的支持有助于维护和改进这个免费的开源交易工具！🚀

---

🎉 大功告成！

现在您应该拥有一个功能完备的 Luno MCP 服务，其中包括：

• ✅ 实时加密货币价格
• ✅ 历史价格数据和 K 线图
• ✅ 价格范围分析和统计数据
• ✅ 多币种支持（ZAR、EUR、GBP、USD）
• ✅ 账户管理工具
• ✅ 交易功能
• ✅ FastMCP 2.0 架构

向 Claude 提问：“Bitcoin 的 EUR 价格是多少？”或“显示过去一周的 XBTZAR 价格历史”来进行测试！