タップツール API MCP

Pythonベースのモデルコンテキストプロトコル（MCP）サーバー。TapTools APIへのアクセスを提供し、ClaudeやGPTなどの大規模言語モデル（LLM）がCardano関連データ（トークン、NFT、市場情報など）を取得できるようにします。このサーバーはTapTools APIの操作をMCP「ツール」として標準化し、AIワークフローへの容易な統合を可能にします。

特徴

• 非同期実装: 非ブロッキング IO に最新の Python 非同期パターンと httpx を使用します。
• 安全な認証: 環境変数または.envファイルからTAPTOOLS_API_KEYを読み取ります。
• MCP 対応: TapTools 機能を、MCP 準拠のクライアントからアクセスできる「ツール」として公開します。
• トークン操作: 価格、トップトークン、時価総額データ、取引量統計など。
• NFT オペレーション: NFT コレクションの統計、取引、リスト、配布など。
• 市場データ: 取引量、アドレス、保有者などの集計統計。
• 統合とオンチェーン: オンチェーン データ、ブロック情報、イベント、DEX ペアなどへのアクセス。
• ウォレット データ: ポートフォリオのポジション、トークン/NFT の保有、取引履歴、取引。

クイックスタート

1. リポジトリをクローンします:
   git clone https://github.com/yourusername/taptools-api-mcp.git cd taptools-api-mcp
2. 仮想環境を作成してアクティブ化します。
   python3 -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 依存関係をインストールします:
   pip install -e .
4. TapTools API キーを設定します:
   • オプション A : .envファイルに追加:
     TAPTOOLS_API_KEY=your-real-taptools-api-key
   • オプション B : 環境変数を設定する:
     export TAPTOOLS_API_KEY="your-real-taptools-api-key"
5. MCP サーバーを実行します:
   python -m taptools_api_mcp
   デフォルトでは、MCP 統合のために標準入出力 (stdio) で実行されます。
6. 接続をテストします（オプション）：
   python test_connection.py

使用例

MCP クライアント ( mcp Python CLI ツールなど) がある場合は、サーバーを起動して、利用可能なツールのいずれかを呼び出すことができます。

mcp cliに入ると、次のようなツールを呼び出すことができます。

これにより、TapTools API キーが有効でアクセス可能であることが確認されます。

あるいは、たとえばトークンの時価総額情報を取得するには:

トークンの時価総額、価格、供給量などを含む JSON データを受け取る必要があります。

APIドキュメント: MCPツール

利用可能なMCPツール、そのパラメータ、および簡単な説明の一覧を以下に示します。これらのツールは、正しいJSONペイロードで呼び出す必要があります。すべてのJSONリクエストはsrc/taptools_api_mcp/models/にあるPydanticモデルと一致している必要があります。

1. verify_connection

• 説明: TapTools API 認証を確認します。
• パラメータ: (パラメータなし)
• 使用例:
  { }

2. get_token_mcap

• 説明: トークンの時価総額情報を取得します。
• パラメータ( TokenMcapRequest ):
  { "unit": "string" // required: token unit identifier }
• 使用例:
  { "unit": "lovelace" }

3. get_token_holders

• 説明: トークン保有者の総数を取得します。
• パラメータ( TokenHoldersRequest ):
  { "unit": "string" // required: token unit identifier }
• 使用例:
  { "unit": "lovelace" }

4. get_token_holders_top

• 説明: トップトークン保有者を獲得します。
• パラメータ( TokenTopHoldersRequest ):
  { "unit": "string", // required "page": "number", // optional (default 1) "per_page": "number"// optional (default 20) }
• 使用例:
  { "unit": "some_token_unit", "page": 1, "per_page": 5 }

5. get_nft_asset_sales

• 説明: NFT 資産の販売履歴を取得します。
• パラメータ( NFTAssetSalesRequest ):
  { "policy": "string", // required: NFT policy ID "name": "string" // optional: NFT name }
• 使用例:
  { "policy": "abc123polid", "name": "coolNFT" }

6. get_nft_collection_stats

• 説明: NFT コレクションの統計を取得します。
• パラメータ( NFTCollectionStatsRequest ):
  { "policy": "string" // required: NFT collection policy ID }
• 使用例:
  { "policy": "abc123polid" }

7. get_market_stats

• 説明: 市場全体の統計を取得します。
• パラメータ( MarketStatsRequest ):
  { "quote": "string" // optional, default "ADA" }
• 使用例:
  { "quote": "USD" }

8. get_integration_asset

• 説明: ID (統合エンドポイント) で資産の詳細を取得します。
• パラメーター( IntegrationAssetRequest ):
  { "id": "string" // required: ID of the asset }
• 使用例:
  { "id": "asset123abc" }

9. get_asset_supply

• 説明: オンチェーン資産の供給を取得します。
• パラメータ( AssetSupplyRequest ):
  { "unit": "string" // required: token unit identifier }
• 使用例:
  { "unit": "lovelace" }

10. get_wallet_portfolio

• 説明: ウォレット ポートフォリオの位置を取得します。
• パラメータ( WalletPortfolioPositionsRequest ):
  { "address": "string" // required: wallet address }
• 使用例:
  { "address": "addr1xyz..." }

(必要に応じて、トークン、NFT、オンチェーンなどの追加のエンドポイントを同じ形式で追加できます。その他の可能なリクエストについてはsrc/taptools_api_mcp/models/フォルダーを参照してください。)

展開

このPython MCPサーバーは、AWS ECS、Azure Container Instances、Google Cloud Runなどのサービスでコンテナ化またはホストできます。TAPTOOLS_API_KEY TAPTOOLS_API_KEYシークレットとして安全に保管してください。Dockerベースのデプロイメントの場合：

注: MCP仕様に従い、サーバーはデフォルトでstdioをリッスンします。高度なデプロイメントやカスタム統合では、環境の要件に応じて、 server.py別のトランスポート（ソケットなど）で実行するように調整できます。