Odos MCP

🚀 Odos MCP Client

このツールは、Odos DEXアグリゲーションプラットフォームとZerionポートフォリオ分析とのやり取りを可能にするModel Context Protocol (MCP)クライアントです。複数のブロックチェーンネットワークにまたがるDeFi取引データ、スワップ見積もり、ポートフォリオ分析、トランザクション履歴への包括的なアクセスを提供します。

🚀 クイックスタート

このクライアントを使用するには、まず必要な環境変数を設定し、MCPサーバーを起動する必要があります。セットアップの検証も行うことができます。

✨ 主な機能

Odos API統合

• スワップ見積もり：DEX流動性ソース全体で最適なスワップルートと価格を取得します。
• Zap操作：単一トランザクションでの流動性供給見積もりを取得します。
• チェーンサポート：Odosがサポートするすべてのブロックチェーンネットワークにアクセスできます。
• トークンデータ：サポートされているトークンのリアルタイム価格とメタデータを取得します。
• ルーター情報：コントラクトアドレスとブロックチェーンインフラストラクチャの詳細を取得します。

Zerion分析

• ポートフォリオ分析：ウォレットの保有資産と構成の詳細な内訳を取得します。
• トランザクション履歴：詳細な過去のトランザクションデータと分析を取得します。
• パフォーマンス追跡：過去のポートフォリオパフォーマンスと収益を追跡します。
• ガス価格監視：ネットワーク全体のリアルタイムガス見積もりを取得します。

📦 インストール

# リポジトリをクローンする
git clone <repository-url>
cd odos-mcp

# 仮想環境を作成してアクティブ化する
python -m venv .venv
source .venv/bin/activate  # Windowsの場合: .venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

# 環境変数を設定する
# .envファイルを作成し、APIキーを追加する（設定セクションを参照）
# または、直接環境変数を設定する:
export ZERION_API_KEY="your_zerion_api_key_here"

# セットアップを検証する（オプションだが推奨）
python scripts/verify_setup.py

💻 使用例

基本的な使用法

必要な環境変数を設定したことを確認し（設定セクションを参照）、MCPサーバーを起動します。

poetry run python -m src.client.server

⚠️ 重要提示

Zerion分析ツールを使用する場合は、ZERION_API_KEYが設定されていることを確認してください。

セットアップの検証

セットアップが正しく構成されていることを確認するには、検証スクリプトを実行します。

python scripts/verify_setup.py

このスクリプトは以下のことを行います。

• すべてのモジュールのインポートをテストします。
• 環境設定を検証します。
• API接続をチェックします。
• ヘルパー関数を検証します。
• 包括的なセットアップレポートを提供します。

📚 ドキュメント

利用可能なツール

APIツール (src/client/tools/api/)

Zerionツール (src/client/tools/zerion/)

⚠️ 重要提示

これらのツールは、ZERION_API_KEY環境変数が設定されている必要があります。

プロジェクト構造

odos-mcp/
├── src/client/                 # コアクライアントパッケージ
│   ├── tools/                  # ツールの実装
│   │   ├── api/               # Odos APIツール
│   │   └── zerion/            # Zerion統合ツール
│   ├── constants.py           # チェーンID、トークンアドレス、APIエンドポイント
│   ├── helpers.py             # APIリクエストのユーティリティ関数
│   ├── mcp_types.py          # APIレスポンスのPydanticモデル
│   └── api_models.py         # 追加のデータモデル
├── scripts/                   # 開発とメンテナンス用のスクリプト
│   ├── verify_setup.py        # セットアップ検証スクリプト
│   └── ...
├── tests/                     # テストスイート
└── requirements.txt          # Pythonの依存関係

設定

環境変数

クライアントには以下の環境変数が必要です。

# 必須: ポートフォリオ分析用のZerion APIキー
export ZERION_API_KEY="your_zerion_api_key_here"

APIキーの取得

Zerion APIキー

Zerion分析ツールを使用するには、Zerion APIキーが必要です。

1. Zerion Developer Portalにアクセスします。
2. 開発者アカウントにサインアップします。
3. 新しいAPIキーを作成します。
4. ZERION_API_KEY環境変数を設定します。

環境変数の設定

プロジェクトのルートに.envファイルを作成します。

# .envファイル
ZERION_API_KEY=your_zerion_api_key_here

または、シェルで直接設定することもできます。

export ZERION_API_KEY="your_zerion_api_key_here"

APIエンドポイント

以下のAPIエンドポイントが使用されます（アプリケーション内でハードコードされています）。

• Odos API: https://api.odos.xyz（認証不要）
• Zerion API: https://api.zerion.io（APIキーが必要）

開発

開発環境のセットアップ

# 開発用の依存関係をインストールする
pip install -r requirements-dev.txt

# フォーマットを実行する
python scripts/format.py

# テストを実行する

新しいツールの追加

1. 適切なディレクトリ (api/ または zerion/) にツールファイルを作成します。
2. 簡単な説明ドキュメント文字列を追加します。
3. FastMCPデコレータパターンを使用して実装します。
4. __init__.pyのエクスポートを更新します。
5. tests/ディレクトリにテストを追加します。

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

サポート

質問や問題がある場合は、以下のことを行ってください。

• リポジトリにイシューを作成します。
• 既存のドキュメントとツールの説明を確認します。
• パラメータの詳細については、Odos APIドキュメントを確認します。