🚀 Luno MCP Server - FastMCP 2.0

🚀 Luno MCP Server - FastMCP 2.0

FastMCP 2.0 と Python 3.12 で構築された、Luno 暗号資産取引所向けの最新の Model Context Protocol（MCP）サーバーです。

✅ クイックスタート

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（始値、高値、安値、終値）+ 出来高
• 上限： 1 リクエストあたり最大 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 クライアント： 非同期 HTTP リクエスト用の httpx
• トランスポート： 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 サーバーが使えるようになります。

• ✅ 暗号資産価格のリアルタイム表示
• ✅ 過去の価格データとローソク足チャート
• ✅ 価格帯の分析と統計
• ✅ 複数通貨への対応（ZAR、EUR、GBP、USD）
• ✅ アカウント管理ツール
• ✅ 取引機能
• ✅ FastMCP 2.0 アーキテクチャ

「EUR建てのBitcoin価格はいくらですか？」または「過去1週間のXBTZARの価格履歴を表示して」と Claude に尋ねて、動作を確認しましょう！