Portal MCP Server

SQD门户MCP服务器

围绕MCP的薄包装 SQD门户网站API 用于区块链数据查询。

此服务器本身不索引链。它验证用户输入，将其映射到门户请求上，并返回MCP友好的响应。

当前公共表面

• 24 公共工具
• 3 高级/调试工具
• 公共参数使用 network
• 发现筛选器使用 vm
• 中没有遗留工具别名 v0.7.7

原始查询工具默认为压缩响应。请求 response_format: "full" 只有当你需要更大的有效载荷时。

工具组

发现：

• portal_list_networks
• portal_get_network_info
• portal_get_head

跨链便利性：

• portal_get_recent_activity
• portal_get_wallet_summary
• portal_get_time_series

EVM：

• portal_evm_query_transactions
• portal_evm_query_logs
• portal_evm_query_token_transfers
• portal_evm_get_contract_deployment
• portal_evm_get_contract_activity
• portal_evm_get_analytics
• portal_evm_get_ohlc

索拉纳：

• portal_solana_query_transactions
• portal_solana_query_instructions
• portal_solana_get_analytics

比特币：

• portal_bitcoin_query_transactions
• portal_bitcoin_get_analytics

基底：

• portal_substrate_query_events
• portal_substrate_query_calls
• portal_substrate_get_analytics

超液体：

• portal_hyperliquid_query_fills
• portal_hyperliquid_get_analytics
• portal_hyperliquid_get_ohlc

高级/调试：

• portal_debug_query_blocks
• portal_debug_resolve_time_to_block
• portal_debug_hyperliquid_query_replica_commands

支持的数据

• Portal索引的EVM网络，包括Base、以太坊、Optimism、Arbitrum、Monad、Hyperliquit EVM等
• Solana主网
• 比特币主网
• 超液体填充和副本命令
• 门户网站索引的底层网络

基板支持目前只是历史性的。它没有实时尾巴。

响应形状

大多数工具返回正常的结果正文和共享元数据，例如：

• _freshness
• _coverage
• _pagination
• _ordering

面向图表的工具还返回图表和表描述符，因此MCP客户端或LLM可以在不逆向工程有效负载的情况下呈现它们。

服务器不提供自己的前端。它返回结构化数据和呈现提示供客户端使用。

安装

npm install
npm run build

跑

标准 ：

npm start

HTTP：

npm run start:http

克劳德桌面版

将这样的条目添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "sqd-portal": {
      "command": "node",
      "args": ["/absolute/path/to/sqd-portal-mcp-server/dist/index.js"]
    }
  }
}

使用说明

• 如果您不知道确切的网络名称，请从 portal_list_networks.
• 如果您需要最近的索引状态，请使用 portal_get_network_info 或 portal_get_head 第一。
• 如果问题很宽泛，从 portal_get_recent_activity, portal_get_wallet_summary，或 portal_get_time_series 在转向原始查询之前。
• 使用 portal_evm_get_ohlc 和 portal_hyperliquid_get_ohlc 只有当你真正需要蜡烛形输出时。
• 对于大型或探索性查询，首选 response_format: "compact" 除非你需要完整的唱片形状。

可观测性

HTTP模式在以下位置公开健康状态 /healthPrometheus指标可在以下网址获得 /metrics，但默认情况下端点是私有的：

• 集 METRICS_BEARER_TOKEN 并刮擦 Authorization: Bearer .
• 集 METRICS_PUBLIC=true 仅适用于有意使用公共指标的本地/dev环境。
• 如果两个变量都没有设置， /metrics 回报 404.

捆绑的Grafana仪表板位于 grafana/portal-mcp-dashboard.json。它使用：

• 普罗米修斯活着 /metrics 抓取数据，如请求率、活动呼叫、延迟和响应大小。
• Loki用于长窗口工具调用历史。配置 GRAFANA_LOKI_URL 加上 GRAFANA_LOKI_TOKEN 或 GRAFANA_LOKI_USERNAME/GRAFANA_LOKI_PASSWORD 推送结构化工具事件。

有用的环境变量：

• OBS_SERVICE_NAME （默认值 sqd-portal-mcp)
• OBS_ENV （默认值 NODE_ENV 或 production)
• OBS_LOG_JSON=true 向stderr发出结构化事件
• OBS_CAPTURE_USER_QUERY=true 包括转发 x-mcp-user-query 遥测中的文本
• METRICS_BEARER_TOKEN 保护 /metrics
• METRICS_PUBLIC=true 故意揭露 /metrics 无身份验证

对于30天的Grafana窗户，普罗米修斯必须刮擦 /metrics 或者Loki事件面板必须由配置的日志导出支持。进程中的Prometheus计数器不能自行回填历史。

测试

npm test
npm run test:tools
npm run test:routing
npm run test:substrate
npm run test:timestamps
npm run test:observability
npm run test:conversations
npm run test:negative
npm run test:quality
npm run test:ci

许可证

麻省理工学院