Seitrace MCP

🚀 Seitrace MCP

Seitrace MCP 是 Sei 區塊鏈必不可少的 MCP（模型上下文協議）服務器，為用戶提供便捷的資源查詢和操作接口，助力開發者高效開發。

🚀 快速開始

請先點擊此處免費獲取 API 密鑰。

✨ 主要特性

可用工具 🧰

形成基於資源接口的五個工具：

• 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 — 查詢智能合約詳情。

MCP 為終端用戶和助手提供的特性

• 以自然語言訪問 Seitrace 洞察數據。助手可代表你進行 API 調用。
• 自描述工具流程：枚舉操作、檢索輸入模式，然後調用。
• 使用每個操作的 JSON 模式進行輸入驗證並提供清晰的錯誤消息。
• 簡潔的發現機制：最小化列表輸出；僅在調用操作時提供詳細的有效負載。
• 與支持 MCP 的 VS Code 擴展（如 Continue、Cline）集成。
• 通過環境變量（作為 x-api-key 發送）進行簡單、安全的 API 密鑰處理。
• 通過 npx 快速啟動：npx -y @seitrace/mcp。

📦 安裝指南

npm install

🔐 配置

將 .env.example 複製為 .env，並根據需要設置值。

環境變量：

• API_BASE_URL（可選） — 默認值為 https://seitrace.com/insights
• SECRET_APIKEY — Seitrace API 密鑰；用於設置請求頭 x-api-key

💻 使用示例

基礎用法

使用 MCP SDK 通過五個工具驅動基於資源的流程：

// 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 響應。

高級用法

可與 VSCode 變體、Claude Desktop / Cursor 一起使用，詳情請參閱 mcp。

使用 MCP 客戶端時，需配置客戶端以啟動編譯後的服務器二進制文件：

• 命令：npx
• 參數：["-y", "@seitrace/mcp"]
• 環境變量：SECRET_APIKEY，API_BASE_URL（可選）

連接成功後，客戶端將調用 tools/list，返回代表資源接口的五個工具。

🏃 構建與運行

# 類型檢查並編譯到 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