关于 web3ctx
web3ctx 是面向 Agent 和开发者的 MCP 服务,提供按版本固定的 Web3 文档、规范与集成资料。它结合可搜索记录、人工验证的链上配方和可重新获取的提交引用。
主要功能
- 01按版本搜索 Web3 内容
- 02精确查询标识符
- 03分页获取完整内容
- 04按深度查看依赖闭包
- 05查询地址、ABI 和 EIP 记录
- 06人工验证的链上配方
适用场景
- 01查找特定版本的集成说明
- 02核对部署地址或 ABI
- 03追踪项目依赖
- 04通过链上收据核验配方
MCP 相关
通过 MCP 暴露搜索、grep、获取内容、查询依赖和结构化查询五种工具。MCP 客户端可连接其远程 HTTP 端点。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.scarai.xyz/mcpclaude mcp add --transport http farseensh-web3ctx https://mcp.scarai.xyz/mcp{"mcpServers":{"farseensh-web3ctx":{"type":"http","url":"https://mcp.scarai.xyz/mcp"}}}在 Cursor 中打开{"servers":{"farseensh-web3ctx":{"type":"http","url":"https://mcp.scarai.xyz/mcp"}}}在 VS Code 中打开{"mcpServers":{"farseensh-web3ctx":{"type":"http","url":"https://mcp.scarai.xyz/mcp"}}}{"mcpServers":{"farseensh-web3ctx":{"serverUrl":"https://mcp.scarai.xyz/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | |
| kind | enum | 是 | address | abi | eip |
| chain | string | 否 | |
| project | string | 否 | |
| version | string | 否 |
详细介绍
web3ctx
Agent 签名前的最后一公里。
由人工验证、在链上运行的 Web3 集成方案,通过 MCP 按真实版本提供。
五种工具
| 工具 | 功能 |
|---|---|
web3_search | 按相关性排序、限定版本的内容单元;问题符合条件时,还会提供人工验证的方案 |
web3_grep | 在语料库中精确查找标识符 |
web3_fetch | 按稳定选择器获取完整内容,长内容支持游标分页 |
web3_deps | 按深度逐层获取依赖闭包 |
web3_lookup | 获取类型化记录,如部署地址、ABI、EIP;找不到时会如实返回 NOT_FOUND |
一个真实的回答
“如何使用 CCTP 跨链转移 USDC” — 2026-08-28 调用一次无需身份验证的端点:
{
"intent": "lookup",
"recipe": {
"project_id": "cctp",
"version": "2",
"recipe_type": "usdc-bridge-send",
"last_validated": "2026-08-07",
"validated_by": "farseen (github: FarseenSh)",
"receipts": {
"validated_on": "2026-08-07",
"validated_by": "farseen (github: FarseenSh)",
"checks": [
"attest",
"test"
],
"chains_exercised": [
"base-sepolia",
"arbitrum-sepolia"
],
"on_chain": [
{
"kind": "txHash",
"hash": "0xd4b4e6395f52ad726dd6062e7a7ec47a2d3a7875d36f20fbb154cde756a3d0f5",
"role": "approve",
// … 207 more lines — the receipts, the
// validated recipe body, and ten citations each pinned to a commit or an exact package version.
完整响应共 26,191 字节(sha256 bc58a9feba1f6309…),并逐字节公开: evidence/showcase/cctp-search.json。你可以将它与自己的调用结果进行比较。
为什么要做这个项目
不会被错误前提蒙骗。 十个问题都建立在经核实为假的前提上:已归档的仓库、已更名的包、不存在的版本。web3ctx
十次中被骗 0 次;其他每个方案都至少被骗过一次(十次中 1–3 次)。
🔴 我们自己的 intent=integrate 行也被骗过一次,此处与其他结果一并公开:
某个方案中的一行误引了一个已归档的仓库。
查看十个陷阱及各方案的回答 →
可重新获取的引用。 每个内容单元都附有 project@version 和一个固定到
40 位提交哈希的 URL:在经过审计的载荷中,144 条里有 142 条符合此标准,而每个对比工具的结果约为 0 条。
审计方案 →
不知道时,就直说。 面对索引中没有的八个项目,它对这八个项目都明确表示无法回答,并指出各自需要什么信息才能解决。竞争对手则回答了其中大多数问题。 ⚠ 任意位置都没有虚构的记录,包括我们自己的结果——这一列无法区分任何方案,因此我们如实报告,而不将其宣称为优势。 诚实地弃答 →
方案才是我们的护城河。 每个方案都由人工在实时链上运行,并附有交易回执,因此任何人都可以通过 RPC 核验相关说法,而不必相信标记。
如实说明新鲜度
每个内容单元都附有 as_of——我们固定的提交的提交者日期——以及指向不可变、可重新获取引用的引文。重建是有日期的事件,会记录到 corpus_version 中,并与索引上次加载的时间一起显示在覆盖范围页面上。🔴 我们没有在任何地方承诺刷新频率,因为我们无法维持固定频率。已归档仓库中标注的 2020 年日期并不代表内容过时——那是上游曾发布的最新内容。
各项目日期和覆盖范围 →
快速开始
claude mcp add --transport http web3ctx https://mcp.scarai.xyz/mcp
{ "mcpServers": { "web3ctx": { "type": "http", "url": "https://mcp.scarai.xyz/mcp" } } }
Cursor、Windsurf、Zed 和任何 MCP 客户端:将同一个 URL — https://mcp.scarai.xyz/mcp — 添加为远程 HTTP 服务。无需密钥,无需注册 — 免费层提供读取路径,并且始终如此。
Claude Code Skill — 同一个入口,内置升级阶梯和两条阅读规则(空闲时约 100 个 token):npx skills add FarseenSh/web3ctx,或将 skills/web3context/ 复制到 .claude/skills/。
CLI — 在 MCP 客户端之外使用同样的五个基本操作,使用相同的协议和载荷约定:npx web3ctx lookup eip 4337,或 npm i -g web3ctx (npm)。它会打印服务端返回的内容,不做任何重塑。
如何回答问题
打开交互式地图 → — 悬停在任意组件上可查看详情、追踪路由并体验三个引导视图。
解析实体 → 根据证据绑定版本或 ABSTAIN → 通过 SQL 谓词筛选,再在结果内使用 BM25 排序 → 确保载荷符合预算,先提供引用,再提供正文。端到端确定性执行 — 服务路径上不使用模型。
证据
本仓库收录了上述所有声明背后的测量数据 — 包括失败的实验、未能通过的门槛,以及我们对错误发布内容所做的更正。按规则不公开竞品载荷的 字节数;其协议、哈希和计数均在此列出,因此任何计数都可以通过实时工具重新运行。
阅读证据 → · 概览 · 评估 · 覆盖范围 — 是否包含你的技术栈? · 谁在运行它,以及它会记录什么 · 架构
采用 MIT(代码和网站)和 CC BY 4.0(证据文档)许可 — 为何采用两种许可。服务端返回的每个单元都是第三方开源仓库的摘录,依据其自身的许可提供,并固定到特定提交。
632 个集成项目 + 1,193 个规范 ID(609 个 ERC + 583 个核心 EIP + 1 个同时存在于两个仓库中)= 总计 1,825 个 · 1,346,624 个单元 · 26 个人工标注的配方。 此页面上的每个数字均在发布时从实时数据库读取;没有任何数字是手动输入的。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
