Seitrace MCP

🚀 Seitrace MCP

Seitrace MCP 是 Sei 區塊鏈必不可少的 MCP（模型上下文協議）服務器，它為用戶提供了便捷的資源管理和查詢功能，助力開發者高效開發與交互。

🚀 快速開始

確保你可以在 此處 免費獲取 API 密鑰。

✨ 主要特性

MCP 為終端用戶和助手提供了以下功能：

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

📦 安裝指南

npm install

💻 使用示例

基礎用法

使用 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 主體。

高級用法

在實際使用中，你可以根據不同的需求靈活組合這些工具，以實現更復雜的功能。例如，結合多個資源操作，對不同類型的代幣進行綜合查詢和分析。

📚 詳細文檔

可用工具 🧰

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

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

與 VSCode 變體、Claude Desktop / Cursor 一起使用 💻

詳情請參閱 mcp

與 MCP 客戶端一起使用 🤝

配置你的 MCP 客戶端以啟動編譯後的服務器二進制文件：

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

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

典型流程 🔁

如上述使用示例所示，通過 MCP SDK 驅動基於資源的流程。

配置 🔐

將 .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/ 中使用小型、專注的模塊來實現共享邏輯。

🔧 技術細節

系統要求

• Node.js 20+
• Seitrace Insights API 密鑰（發現功能可選，大多數即時調用需要），可在 此處 獲取

運行機制

該服務器旨在由 MCP 兼容的客戶端啟動，通過標準輸入輸出（stdio）進行通信。客戶端通過配置命令和參數來啟動服務器，並與之進行交互。

📄 許可證

詳情請參閱 LICENSE

📨 支持

如有任何問題，請發送電子郵件至 dev@cavies.xyz