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/insightsSECRET_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