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

関連リンク

• Zaif API公式ドキュメント
• Zaif公式サイト
• Model Context Protocol公式サイト
• FastMCP公式ドキュメント

免責事項

本ソフトウェアは暗号資産取引所のAPIを利用しますが、取引の結果について一切の責任を負いません。 本アプリケーションはZaif取引所の非公式・非公認のサードパーティ製ツールであり、Zaif取引所および株式会社Zaifによる保証はありません。 実際の取引を行う前に、必ず動作を十分に確認し、自己責任で利用してください。