MCP-ATP: Model Context Protocol Server for IQ AI Agent Tokenization Platform

🤖 MCP-ATP：エージェントトークン化プラットフォーム

📖 概要

MCP-ATP サーバーを使用すると、AI エージェントは IQ AI のエージェントトークン化プラットフォーム（ATP）を利用できます。このサーバーは、エージェントの統計情報、トークンの保有状況、取引機能、エージェントのログに包括的にアクセスできます。

Model Context Protocol（MCP）を実装することで、このサーバーを通じて大規模言語モデル（LLM）は AI エージェントを検出し、エージェントのパフォーマンスを分析し、エージェントトークンを取引し、コンテキストウィンドウから直接エージェントのログを管理できます。これにより、AI と分散型エージェントトークン化の間のギャップを埋めます。

✨ 機能

• エージェントの検出：AI エージェントの統計情報や詳細を検索、取得します。
• ポートフォリオの追跡：ユーザーが保有する ATP AI トークンを監視します。
• トークン取引：IQ を基軸通貨として、AI エージェントトークンを売買します。
• ログ管理：特定の AI エージェントのログを取得、追加します。

📦 インストール

🚀 pnpm dlx を使用する（推奨）

グローバルにインストールせずにこのサーバーを使用するには：

pnpm dlx @iqai/mcp-atp

🔧 ソースからビルドする

git clone https://github.com/IQAIcom/mcp-atp.git
cd mcp-atp
pnpm install
pnpm run build

⚡ MCP クライアントで実行する

以下の設定を MCP クライアントの設定（例：claude_desktop_config.json）に追加してください。

📋 最小限の設定

{
  "mcpServers": {
    "atp": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/mcp-atp"],
      "env": {
        "ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

⚙️ 高度な設定（ローカルビルド）

{
  "mcpServers": {
    "atp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-atp/dist/index.js"],
      "env": {
        "ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key_here",
        "ATP_API_KEY": "your_atp_api_key_if_needed"
      }
    }
  }
}

🔐 設定（環境変数）

変数	必須	説明	デフォルト
ATP_WALLET_PRIVATE_KEY	はい*	取引およびポジション照会用のウォレット秘密鍵	-
ATP_API_KEY	いいえ	特定のバックエンドサービス用の API キー	-

*ATP_GET_AGENT_POSITIONS、ATP_BUY_AGENT、ATP_SELL_AGENT ツールで必須です。

**セキュリティに関する注意：**秘密鍵は細心の注意を払って取り扱ってください。安全に保管し、信頼できる MCP クライアント設定にのみ提供してください。

💡 使用例

🔍 エージェントの検出

• 「ATP のトップ AI エージェントはどれですか？」
• 「トークンコントラクト 0x123... のエージェントの統計情報を取得して」
• 「名前またはカテゴリで AI エージェントを検索して」

📊 ポートフォリオ管理

• 「ATP AI トークンの現在のポジションを教えて」
• 「ウォレット 0xabc... の保有状況を表示して」

💹 取引

• 「0x123... のエージェントトークンを、IQ 100 分購入して」
• 「エージェント 0x456... のポジションを売却して」

📝 ログ管理

• 「エージェント 0x123... の最新ログを取得して」
• 「自分のエージェントに新しいログエントリを追加して」

🛠️ MCP ツール

ATP_ADD_AGENT_LOG

特定の AI エージェントに新しいログエントリを追加します。パラメーターとして API キーが必要です。

パラメーター	型	必須	説明
agentTokenContract	string	はい	エージェントトークンのコントラクトアドレスです。
content	string	はい	ログメッセージの内容です。
txHash	string	いいえ	このログエントリに関連付けるトランザクションハッシュ（任意）です。
chainId	integer	いいえ	このログエントリに関連付けるチェーン ID（任意）です。

ATP_AGENT_STATS

ATP プラットフォーム上の指定した AI エージェントの統計情報と詳細を取得します。

パラメーター	型	必須	説明
tokenContract	string	はい	エージェントトークンのコントラクトアドレスです（例：0x123...abc）。

ATP_BUY_AGENT

IQ を基軸通貨として AI エージェントトークンを購入します。

パラメーター	型	必須	説明
tokenContract	string	はい	購入するエージェントトークンのコントラクトアドレスです。
amount	string	はい	エージェントトークンの購入に使用する基軸通貨（IQ）の数量です。wei 単位で指定します（例：1 IQ の場合は '1000000000000000000'）。

ATP_GET_AGENT_LOGS

ページネーションを使用して、特定の AI エージェントのログを取得します。

Parameter	Type	Required	Description
agentTokenContract	string	Yes	エージェントトークンのコントラクトアドレスです。
page	integer	No	ページネーションのページ番号です。デフォルトは 1 です。
limit	integer	No	1 ページあたりのログ数です。デフォルトは 10 です。

ATP_GET_AGENT_POSITIONS

ユーザーのポジションを取得します

パラメーターはありません

ATP_GET_AGENTS

ATP プラットフォームから AI エージェントの一覧を取得します。並べ替えと件数制限を指定できます。

Parameter	Type	Required	Default	Description
sort	string	No

    エージェントを時価総額、保有者数、または推論数で並べ替えます。
    使用可能なオプションは次のとおりです。
    - mcap: 時価総額で並べ替え
    - holders: 保有者数で並べ替え
    - inferences: 推論数で並べ替え
    指定されていない場合、時価総額で並べ替えます。
   |

| limit | integer | No | 100 | |

ATP_SELL_AGENT

AI エージェントのトークンをプロトコルに売却します。

Parameter	Type	Required	Description
tokenContract	string	Yes	売却するエージェントトークンのコントラクトアドレスです。
amount	string	Yes	売却するエージェントトークンの数量です。wei 単位で指定します（例：1 トークンの場合は '1000000000000000000'）。

👨‍💻 開発

🏗️ プロジェクトのビルド

pnpm run build

👁️ 開発モード（監視）

pnpm run watch

✅ リントとフォーマット

pnpm run lint
pnpm run format

📁 プロジェクト構成

• src/tools/: 個々のツール定義
• src/services/: API クライアントとビジネスロジック
• src/lib/: 共通ユーティリティ
• src/index.ts: サーバーのエントリーポイント

📚 リソース

• IQ AI エージェントプラットフォーム
• Model Context Protocol（MCP）
• IQ Wiki

⚠️ 免責事項

このプロジェクトは、ブロックチェーンベースの金融取引を扱います。ユーザーは注意を払い、すべての取引を自ら確認してください。エージェントトークンの取引にはリスクが伴います。

📄 ライセンス

ISC