Zaifer-MCP

# zaifer-mcp    Zaif暗号資産取引所のAPIを[Model Context Protocol (MCP)](https://modelcontextprotocol.io/)経由で利用可能にするPythonライブラリです。ClaudeなどのLLMアシスタントから自然言語でZaif APIの機能を直接呼び出せます。 ## ⚠️ 重要な注意事項 **本アプリケーションは非公式・非公認のサードパーティ製ツールです。** Zaif取引所および株式会社Zaifとは一切関係がありません。 ## 特徴 - 🤖 **LLMフレンドリー**: Claude、ChatGPTなどのLLMから自然言語で暗号資産取引機能を利用 - 🔒 **セキュア**: API認証が必要な操作は適切に保護され、公開情報は安全にアクセス可能 - 📊 **包括的な機能**: 市場情報、チャートデータ、取引、アカウント管理の全機能をサポート - 🚀 **高速**: FastMCPフレームワークによる効率的な実装 - 🔌 **柔軟な接続**: STDIO（ローカル）とHTTP（リモート）の両方の通信方式をサポート ## サポート通貨ペア - **BTC/JPY** (ビットコイン/日本円) - **ETH/JPY** (イーサリアム/日本円) - **XYM/JPY** (シンボル/日本円) ## インストール ```bash # リポジトリをクローン git clone https://github.com/curio184/zaifer-mcp.git cd zaifer-mcp # パッケージをインストール pip install -e . ``` ## 環境設定 zaifer-mcpは**APIキーなしでも市場情報の取得が可能**です。Zaifの口座をお持ちでAPIキーを発行いただければ、残高確認や取引機能を含むすべての機能をご利用いただけます。 ## 使用方法 ### Claude Desktopとの連携 ```bash # リポジトリをクローン 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) に以下を設定： ```json { "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](DEVELOPMENT.md)をご覧ください。 ## ライセンス このプロジェクトはMITライセンスの下で公開されています。詳細は[LICENSE](LICENSE)ファイルを参照してください。 ## 著者 **Yusuke Oya** - [curio@antique-cafe.net](mailto:curio@antique-cafe.net) ## 関連リンク - [Zaif API公式ドキュメント](https://zaif-api-document.readthedocs.io/ja/latest/) - [Zaif公式サイト](https://zaif.jp/) - [Model Context Protocol公式サイト](https://modelcontextprotocol.io/) - [FastMCP公式ドキュメント](https://github.com/jlowin/fastmcp) ## 免責事項 本ソフトウェアは暗号資産取引所のAPIを利用しますが、取引の結果について一切の責任を負いません。 本アプリケーションはZaif取引所の非公式・非公認のサードパーティ製ツールであり、Zaif取引所および株式会社Zaifによる保証はありません。 実際の取引を行う前に、必ず動作を十分に確認し、自己責任で利用してください。