Seitrace Insights MCP Server

Seitrace MCP

Sei区块链的基本MCP（模型上下文协议）服务器。

可用工具🧰

形成基于资源的接口的五个工具（按顺序1使用→2→3→4):

• list_resources --列出可用资源（从这里开始）
• list_resource_actions --列出资源的操作
• get_resource_action_schema — 必需 在调用之前获取操作的JSON模式
• invoke_resource_action --使用与模式匹配的有效负载调用操作
• get_resource_action_snippet --（可选）生成代码片段，以指定语言执行资源操作

支持的资源

将军

• general_faucet -为开发人员启用请求水龙头
• general_rpc_lcd -为代理启用通用rpc/lcd查询，并根据需求执行rpc/lcd请求
• general_associations --跨EVM和本地Sei查询混合关联（EOA/assets/tx）。在适用的情况下返回简化的指针/指针字段。

洞察

• 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 --查询智能合约详细信息。
• insights_assets --按名称/符号/标识符搜索官方资产，并按标识符获取资产详细信息。使用Sei网关端点；在获取的资产列表上离线执行搜索。
• insights_earnings --搜索/列出pacific-1的收益池（APR/APY），并按地址提取池。返回简化字段：名称、地址、url、图像、提供者、tvl、apr、apy。
• insights_transactions --通过网关（pacific-1、atlantic-2、arctic-1）按哈希查询交易详细信息。

智能合约

• smart_contract --通过Multicall3查询智能合约状态，搜索已验证的合约，或从Seitrace下载智能合约ABI（pacific-1、atlantic-2、arctic-1）。

入门

确保您免费获得API密钥 这里

检查 安装指南

亮点✨

MCP为终端用户和助手提供了什么：

• 自然语言访问Seitrace见解。助理代表您执行API调用。
• 自描述工具流：枚举操作，检索输入模式，然后调用。
• 使用按操作JSON模式输入验证和清除错误消息。
• 简明发现：最小列表输出；仅在调用操作时提供详细的有效载荷。
• 与启用MCP的VS代码扩展（例如Continue、Cline）集成。
• 通过环境变量进行简单、安全的API密钥处理（以 x-api-key).
• 通过npx快速入门： npx -y @seitrace/mcp.

典型流量🔁

使用MCP SDK，通过五个工具驱动基于资源的流。 重要提示： 始终遵循以下顺序，特别是步骤3：

// 1) Discover available resources
const resources = await client.callTool({ name: 'list_resouces', arguments: {} });
// -> { resources: ['erc20', 'erc721', 'native', ...] }

// 2) List actions for a resource
const actions = await client.callTool({
  name: 'list_resouce_actions',
  arguments: { resource: 'insights_erc20' },
});
// -> { resource: 'erc20', actions: [{ name, description }, ...] }

// 3) **REQUIRED** Get the JSON Schema for a specific action
// This step is critical - parameter names in descriptions may differ from actual schema
const schema = await client.callTool({
  name: 'get_resource_action_schema',
  arguments: { resource: 'insights_erc20', action: 'get_erc20_token_info' },
});
// -> { resource: 'insights_erc20', action: 'get_erc20_token_info', schema }
// The schema reveals exact parameter names like "q" instead of "query", "chain" instead of "chain_id", etc.

// 4) Invoke the action with payload matching the schema structure
const res = await client.callTool({
  name: 'invoke_resource_action',
  arguments: {
    resource: 'insights_erc20',
    action: 'get_erc20_token_info',
    payload: { chain: 'pacific-1', contract_address: '0x...' },
  },
});
// res.content[0].text -> "API Response (Status: 200):\n{ ... }"

// 5) Optionally, generate a code snippet for an action
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

构建并运行🏃

# Type-check and compile to build/
npm run build

# Run the MCP server over stdio (used by MCP clients)
npm start

此服务器设计为由MCP兼容客户端启动（例如，通过命令/args配置）。它通过stdio进行通信。

端到端测试✅

运行E2E以验证根资源流和（可选）实时肯定呼叫：

# Optionally provide your API key so the positive path runs
SEITRACE_API_KEY=your_key_here npm run test:e2e

故障排除🛠️

请确保您运行我们的e2e测试，以查看我们涵盖的常见错误。

• E2E： npm run test:e2e （可选 E2E_DEBUG=1 为了 [E2E] 日志）。
• 节点：使用v20+。

贡献🤝

• 保持 tools/list 输出紧凑。不要在那里嵌入每个操作的详细信息——通过以下方式获取 getResourceActionSchema.
• 新端点应出现在正确的资源下；根工具方法应该一致地提供发现和调用。
• 更喜欢小型、重点突出的模块 src/lib/ 共享逻辑。

许可证📄

看 许可证

支持📨

请发送电子邮件至dev@cavies.xyz