核心用法
Substreams Search MCP 是一款面向区块链数据工程师的专用工具，提供从 Substreams 包发现到部署的全链路支持。用户可通过 search_substreams 工具在 substreams.dev 注册表中按关键词、排序规则和区块链网络（Ethereum、Solana、Arbitrum、Base 等）检索数据包；使用 inspect_package 深度解析 .spkg 文件，获取模块依赖图（DAG）、Protobuf 输出类型及 Mermaid 可视化图表；list_package_modules 提供轻量级模块列表视图，快速浏览输入输出类型；get_sink_config 则负责分析 Sink 配置，自动提取 SQL 模式并生成可直接运行的 CLI 部署命令，支持 PostgreSQL、ClickHouse 和 subgraph 实体等主流数据接收端。
运行环境仅需 Node.js ≥ 18，通过 npx substreams-search-mcp 零配置启动，SSE 传输层默认监听 3849 端口（可通过 MCP_HTTP_PORT 覆盖）。所有操作均基于公开 API，无需任何 API 密钥或身份认证。
显著优点
零门槛接入：完全依赖公开 API 和公共注册表，消除密钥管理负担，降低新手入门成本。
可视化洞察：自动生成 Mermaid 格式的模块依赖图，使复杂的数据流管道一目了然，便于团队沟通和架构评审。
部署即代码：get_sink_config 直接输出可执行的 CLI 命令，将配置分析转化为可落地的运维指令，显著提升工程效率。
多链兼容：原生支持 Ethereum、Solana、Arbitrum、Base 等主流公链，满足跨生态开发需求。
轻量无状态：不依赖本地数据库或持久化存储，纯运行时工具，容器化部署友好。
潜在缺点与局限性
网络依赖性强：核心功能完全依赖 substreams.dev 和 spkg.io 的可用性，服务中断或 API 变更将直接影响工具功能。
离线场景受限：无法在无网络环境下工作，不支持本地缓存或离线包解析。
功能边界明确：仅聚焦 Substreams 生态，不涵盖 The Graph 原生 subgraph 开发或其他区块链索引方案。
错误处理细节待验证：作为社区贡献工具（GitHub 个人仓库），异常场景下的降级策略和错误提示丰富度可能不及官方企业级产品。
适合的目标群体
- 区块链索引开发者：构建自定义 Substreams 模块，需要快速调研现有生态包的开发者。
- 数据工程师：负责将链上数据接入 PostgreSQL/ClickHouse 等企业级数仓的技术人员。
- DeFi/Analytics 团队分析师：需理解复杂数据包结构、评估第三方模块可靠性的研究人员。
- Web3 基础设施运维：管理多链数据管道部署，追求配置即代码的 DevOps 工程师。
使用风险说明
运行时性能：Node.js 单线程特性在处理超大 .spkg 文件或复杂 DAG 时可能存在解析延迟，建议对生产环境大数据包进行预测试。
依赖项风险：npx 执行模式每次可能拉取最新版本，存在意外引入破坏性变更的潜在风险，生产环境建议锁定版本或采用本地安装。
上游服务稳定性：spkg.io 和 substreams.dev 为第三方公共服务，SLA 无明确保障，关键业务建议实现重试和熔断机制。
数据隐私：虽然无需 API 密钥，但搜索关键词和包查询行为可能通过 HTTP 日志被服务端记录，敏感业务场景需评估合规要求。