Seitrace MCP

🚀 Seitrace MCP

Seiブロックチェーンに必須のMCP（Model Context Protocol）サーバーです。

🧰 利用可能なツール

リソースベースのインターフェースを構成する5つのツール：

• list_resources — 利用可能なリソースを一覧表示
• list_resource_actions — リソースのアクションを一覧表示
• get_resource_action_schema — アクションのJSONスキーマを取得
• invoke_resource_action — ペイロードを指定してアクションを実行
• get_resource_action_snippet — 指定された言語でリソースアクションを実行するためのコードスニペットを生成します。例えば、必要なパラメータでアクションを呼び出すJavaScriptのスニペットです。

サポートされているリソース

一般

• general_faucet - 開発者向けにフォーセットのリクエストを可能にします。
• general_rpc_lcd - エージェントに対する一般的なrpc/lcd問い合わせを有効にし、要求に基づいてrpc/lcdリクエストを実行します。
• general_associations — EVMとネイティブSei間のハイブリッド関連付け（EOA/アセット/トランザクション）をクエリします。適用可能な場合は、簡略化されたポインタ/ポインティフィールドを返します。

インサイト

• insights_address — アドレスデータをクエリします：詳細、トランザクション、トークン転送。
• insights_erc20 — ERC-20トークンをクエリします：情報、残高、転送、保有者。
• insights_cw20 — CW20トークンをクエリします：情報、残高、転送、保有者。
• insights_native — ネイティブトークンをクエリします：情報、転送、残高、保有者。
• insights_ics20 — ICS20トークンをクエリします：情報、転送、残高、保有者。
• insights_erc721 — ERC-721トークンをクエリします：情報、保有者、インスタンス、残高、転送。
• insights_erc1155 — ERC-1155トークンをクエリします：情報、保有者、インスタンス、残高、転送。
• insights_cw721 — CW721トークンをクエリします：情報、インスタンス、残高、保有者、転送。
• insights_smart_contract — スマートコントラクトの詳細をクエリします。

🚀 クイックスタート

こちらから無料でAPIキーを取得してください。

💻 VSCodeバリアント、Claude Desktop / Cursorでの使用

mcpを参照してください。

🤝 MCPクライアントでの使用

MCPクライアントを設定して、コンパイルされたサーバーバイナリを起動します。

• コマンド: npx
• 引数: ["-y", "@seitrace/mcp"]
• 環境変数: SECRET_APIKEY, API_BASE_URL (オプション)

接続すると、クライアントはtools/listを呼び出し、リソースインターフェースを表す5つのツールが返されます。

✨ 主な機能

MCPがエンドユーザーとアシスタントに提供するもの：

• Seitraceのインサイトへの自然言語アクセス。アシスタントが代わりにAPI呼び出しを行います。
• 自己記述型のツールフロー：アクションを列挙し、入力スキーマを取得してから実行します。
• アクションごとのJSONスキーマを使用した入力検証と明確なエラーメッセージ。
• 簡潔な探索：最小限のリスト出力；アクションを実行するときのみ詳細なペイロード。
• MCP対応のVS Code拡張機能（例：Continue、Cline）との統合。
• 環境変数を介したシンプルで安全なAPIキー管理（x-api-keyとして送信）。
• npxを介したクイックスタート: npx -y @seitrace/mcp。

🔁 典型的なフロー

MCP SDKを使用して、5つのツールを介してリソースベースのフローを実行します。

// 1) 利用可能なリソースを探索
const resources = await client.callTool({ name: 'list_resouces', arguments: {} });
// -> { resources: ['erc20', 'erc721', 'native', ...] }

// 2) リソースのアクションを一覧表示
const actions = await client.callTool({ name: 'list_resouce_actions', arguments: { resource: 'insights_erc20' } });
// -> { resource: 'erc20', actions: [{ name, description }, ...] }

// 3) 特定のアクションのJSONスキーマを取得
const schema = await client.callTool({ name: 'get_resource_action_schema', arguments: { resource: 'insights_erc20', action: 'get_erc20_token_info' } });
// -> { resource: 'erc20', action: 'get_erc20_token_info', schema }

// 4) ペイロードを指定してアクションを実行
const res = await client.callTool({ name: 'invoke_resource_action', arguments: { resource: 'insights_erc20', action: 'get_erc20_token_info', payload: { chain_id: 'pacific-1', contract_address: '0x...' } } });
// res.content[0].text -> "API Response (Status: 200):\n{ ... }"

// 5) オプションで、アクションのコードスニペットを生成
const snippet = await client.callTool({ name: 'get_resource_action_snippet', arguments: { resource: 'insights_erc20', action: 'get_erc20_token_info', language: 'node' } });
// -> { resource, action, language, snippet }

サーバーは、アクションのスキーマに対してpayloadを検証し、適用可能な場合は整形されたJSONボディを返します。

🔧 必要条件

• Node.js 20+
• Seitrace Insights APIキー（探索にはオプション、ほとんどのライブ呼び出しには必須）。こちらから取得してください。

📦 インストール

npm install

🔐 設定

.env.exampleを.envにコピーし、必要に応じて値を設定します。

環境変数:

• API_BASE_URL (オプション) — デフォルトはhttps://seitrace.com/insights
• SECRET_APIKEY — Seitrace APIキー；ヘッダーx-api-keyに使用されます。

🏃 ビルドと実行

# 型チェックしてbuild/にコンパイル
npm run build

# stdioを介してMCPサーバーを実行（MCPクライアントで使用）
npm start

このサーバーは、MCP互換のクライアント（例：コマンド/引数構成を介して）によって起動されるように設計されています。stdioを介して通信します。

✅ エンドツーエンドテスト

E2Eテストを実行して、ルートリソースフローと（オプションで）ライブの肯定的な呼び出しを検証します。

# オプションでAPIキーを指定して肯定的なパスを実行
SEITRACE_API_KEY=your_key_here npm run test:e2e

🛠️ トラブルシューティング

カバーされている一般的なエラーを確認するために、E2Eテストを実行してください。

• E2E: npm run test:e2e (オプションでE2E_DEBUG=1を指定すると[E2E]のログが出力されます)。
• Node: v20+を使用してください。

🤝 コントリビューション

• tools/listの出力はコンパクトに保ってください。アクションごとの詳細をそこに埋め込まないでください — getResourceActionSchemaを介して取得してください。
• 新しいエンドポイントは正しいリソースの下に表示する必要があります。ルートツールメソッドは一貫した探索と呼び出しを提供する必要があります。
• 共有ロジックにはsrc/lib/の小さく焦点を絞ったモジュールを使用することをおすすめします。

📄 ライセンス

LICENSEを参照してください。

📨 サポート

ご質問等は、dev@cavies.xyzまでメールをお送りください。