Zaifer-MCP
Enables LLM assistants like Claude to interact with Zaif cryptocurrency exchange through natural language, supporting market information retrieval, chart data, trading, and account management for BTC/JPY, ETH/JPY, and XYM/JPY pairs.
README Documentation
zaifer-mcp
Zaif暗号資産取引所のAPIをModel Context Protocol (MCP)経由で利用可能にするPythonライブラリです。ClaudeなどのLLMアシスタントから自然言語でZaif APIの機能を直接呼び出せます。
⚠️ 重要な注意事項
本アプリケーションは非公式・非公認のサードパーティ製ツールです。 Zaif取引所および株式会社Zaifとは一切関係がありません。
特徴
- 🤖 LLMフレンドリー: Claude、ChatGPTなどのLLMから自然言語で暗号資産取引機能を利用
- 🔒 セキュア: API認証が必要な操作は適切に保護され、公開情報は安全にアクセス可能
- 📊 包括的な機能: 市場情報、チャートデータ、取引、アカウント管理の全機能をサポート
- 🚀 高速: FastMCPフレームワークによる効率的な実装
- 🔌 柔軟な接続: STDIO(ローカル)とHTTP(リモート)の両方の通信方式をサポート
サポート通貨ペア
- BTC/JPY (ビットコイン/日本円)
- ETH/JPY (イーサリアム/日本円)
- XYM/JPY (シンボル/日本円)
インストール
# リポジトリをクローン
git clone https://github.com/curio184/zaifer-mcp.git
cd zaifer-mcp
# パッケージをインストール
pip install -e .
環境設定
zaifer-mcpはAPIキーなしでも市場情報の取得が可能です。Zaifの口座をお持ちでAPIキーを発行いただければ、残高確認や取引機能を含むすべての機能をご利用いただけます。
使用方法
Claude Desktopとの連携
# リポジトリをクローン
git clone https://github.com/curio184/zaifer-mcp.git
Claude Desktop(デスクトップ版)のMCP設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) または %APPDATA%\Claude\claude_desktop_config.json
(Windows) に以下を設定:
{
"mcpServers": {
"zaifer-mcp": {
"command": "python",
"args": ["/path/to/zaifer-mcp/zaifer_mcp/__main__.py"],
"env": {
"ZAIF_API_KEY": "your_api_key_here",
"ZAIF_API_SECRET": "your_api_secret_here"
}
}
}
}
APIキーなしで市場情報のみ利用する場合は、env
セクションを省略できます。設定後、Claude Desktopを再起動すると、zaifer-mcpの機能が利用可能になります。
使用例
Claude での基本的な使用例
ユーザー: ビットコインの現在価格を教えてください
Claude: 現在のビットコイン(BTC/JPY)の価格情報をお調べします。
【BTC/JPY 価格情報】
- 現在価格: ¥14,500,000
- 24時間変動: +2.3%
- 高値: ¥14,520,000 / 安値: ¥14,380,000
- 出来高: 150.3 BTC
Claude は get_ticker
ツールを自動的に呼び出し、リアルタイムの市場データを取得して回答します。
開発者向け情報
開発環境のセットアップ、デバッグ方法、アーキテクチャの詳細についてはDEVELOPMENT.mdをご覧ください。
ライセンス
このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。
著者
Yusuke Oya - curio@antique-cafe.net
関連リンク
免責事項
本ソフトウェアは暗号資産取引所のAPIを利用しますが、取引の結果について一切の責任を負いません。 本アプリケーションはZaif取引所の非公式・非公認のサードパーティ製ツールであり、Zaif取引所および株式会社Zaifによる保証はありません。 実際の取引を行う前に、必ず動作を十分に確認し、自己責任で利用してください。