Seitrace MCP

🚀 Seitrace MCP

Seiブロックチェーンに必要不可欠なMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

まずは、こちらから無料で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。

🧰 利用可能なツール

リソースベースのインターフェイスを構成する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 — スマートコントラクトの詳細を照会します。

💻 使用例

基本的な使用法

// 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を介して通信します。

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

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

# オプションでAPIキーを指定すると、肯定的なパスが実行されます
SEITRACE_API_KEY=your_key_here npm run test:e2e

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

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

• エンドツーエンドテスト: npm run test:e2e (オプションでE2E_DEBUG=1を指定すると[E2E]ログが表示されます)。
• Node: v20以上を使用してください。

🤝 コントリビューション

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

📄 ライセンス

詳細はLICENSEを参照してください。

📨 サポート

質問や要望がある場合は、dev@cavies.xyzまでメールを送信してください。