trust-oracle

WMCP — 将网站转化为 AI Agent 工具

一个 URL → 发现工具 → 连接 MCP 客户端 → 评估可信度。

试用 WMCP · MCP Doctor · 只读 CLI · 原生浏览器演示 · MCP 可信度排行榜 · API 文档

WMCP 是一个托管的 URL-to-MCP 网关，适用于 Claude、Cursor、Codex 和自定义 AI Agent。它从公开网页、结构化数据和有文档说明的 API 中提取候选工具，通过 MCP 提供这些工具，并单独为 MCP 服务提供可信度评级。你可以使用公共服务，也可以自托管 Worker。

并非所有网站都兼容。工具发现尽力而为，发现某个工具并不意味着该操作确实可以运行、网站允许执行该操作或该操作安全。经过身份验证的实时操作需要授权，并且须符合适用的套餐权益。

30 秒快速上手

选项 1：使用浏览器，无需安装。 将公开 URL 粘贴到 wmcp.sh/start，查看推断出的工具，然后决定是否连接 MCP 客户端。

选项 2：使用终端，无需依赖项。 克隆后只需 Node.js 18+：

git clone https://github.com/New1Direction/webmcp-anything.git
cd webmcp-anything

# Discover candidate tools using the hosted REST API.
node cli/wmcp.mjs inspect https://petstore3.swagger.io/api/v3/openapi.json

# Negotiate actual MCP and request tools/list (never tools/call).
node cli/wmcp.mjs mcp https://petstore3.swagger.io/api/v3/openapi.json

# Print a copyable MCP client configuration (no keys included).
node cli/wmcp.mjs config https://petstore3.swagger.io/api/v3/openapi.json

该 CLI 只执行只读请求。它不会安装其他 Agent、进行购买或调用任何工具。运行下方的 Node 测试命令，即可执行该 CLI 的测试和浏览器演示冒烟测试。

选项 3：使用 cURL，无需克隆：

curl -sS 'https://wmcp.sh/api/v1/tools?url=https://petstore3.swagger.io/api/v3/openapi.json'

仅提交公开 URL。托管服务可能会抓取、缓存或索引提交的来源；请勿发送凭据、签名查询参数、私有文件或敏感客户数据。

连接 MCP 客户端

WMCP 提供的是真正的 MCP 端点，而非仅仅外观上类似工具架构的 JSON。将 URL 编码为 base64url，然后使用每个 URL 对应的地址格式：

https://wmcp.sh/mcp/u/<base64url-encoded-URL>

为真实 URL 生成客户端配置：

node cli/wmcp.mjs config https://petstore3.swagger.io/api/v3/openapi.json

生成的 JSON 格式如下：

{
  "mcpServers": {
    "wmcp": {
      "type": "http",
      "url": "https://wmcp.sh/mcp/u/<base64url-encoded-URL>"
    }
  }
}

将示例 URL 占位符替换为 CLI 的实际输出。该端点实现了 JSON-RPC initialize、tools/list 和经授权的 tools/call。速率限制范围内的发现读取免费。实时执行需要授权，且并非所有推断出的操作都可执行。通过 MCP 客户端支持的 Authorization 标头传递付费套餐密钥——切勿将密钥放入 URL 参数或提交到 Git。

可通过 /mcp/url 端点组合多个公开 URL。请参阅 API 参考、架构说明和自托管指南。

网关的工作方式

Public URL
   |
   +-- Shopify storefront/product adapter
   +-- OpenAPI / Swagger compiler
   +-- Crypto/data adapters for supported sources
   +-- Structured JSON-LD extraction
   +-- Best-effort LLM fallback, when configured
   |
   v
Schema + tools ---> Hosted MCP endpoint or JSON REST response
                           |
                      Client approval, auth & execution

检测效果取决于各网站的元数据、网络可访问性和身份验证方式。客户端应用可能需要单独安装浏览器集成。

WebMCP 与后端 MCP 并不相同。 WebMCP 草案使用 document.modelContext 在浏览器中公开网站自身的 JavaScript 工具。WMCP 当前的托管产品主要是后端 URL 适配器和 MCP 网关。原生浏览器互操作功能正在 PR #75 中开发；不要以为远程 MCP 端点无需经过用户同意的会话桥接，就能执行浏览器会话工具。

在 CI 中诊断 MCP 服务

WMCP Doctor 无需调用工具即可检查直接的 MCP HTTP 端点。它会处理协议初始化、会话 ID、工具分页和基本的输入架构规范检查。可将其用作轻量级 CI 预检，而非正式审计或官方 MCP Inspector 的替代品。

node cli/wmcp.mjs doctor https://YOUR_MCP_HOST.example/mcp --json --strict

你还可以将 doctor --json 的输出保存为经审核的基线，然后使用 --baseline path --strict，在 CI 中标记 MCP 工具契约变更。

该端点是示例占位符。支持的检查项、限制和退出代码，请参阅 Doctor 指南。

实时浏览器原生示例

此仓库还包含一个小型 WebMCP 任务看板，具有真实的页面内状态——三个工具（列出、添加、完成），以及一个会在工具运行时更新的 UI。

cd examples/browser-demo
python3 -m http.server 8000

打开 http://localhost:8000。在启用了 WebMCP 的受支持 Chrome/Edge 版本中，兼容的浏览器 Agent 可以发现页面注册的工具。在不受支持的浏览器中，任务看板仍可正常使用，并会提示原生 API 不可用。

查看可运行示例和说明。

独立 MCP 信任报告

免费的 MCP Trust Leaderboard 会检查受支持的 MCP 端点，并发布涵盖可观测协议、工具和安全信号的 A–F 级报告。该信任系统可检测已发现的工具定义随时间发生的变化。

信任等级是风险指标，并非安全认证。它们不代表已审计所有可执行行为，也不授权 Agent 执行操作。免费等级不会出售；另有独立产品提供更深入的评估和监控。

node cli/wmcp.mjs grade https://example.com/mcp

开发者集成

界面	功能	文档
URL 发现	通过公开 HTML 和已知适配器尽力提取	REST API
远程 MCP	将兼容的客户端连接到通过 URL 指定的工具	MCP 快速入门
原生 WebMCP 演示	使用 document.modelContext 的网站自定义工具	任务看板演示
信任评级	检查可观测的 MCP 服务信号	排行榜
Python SDK	以编程方式调用 API 的客户端	Python
JavaScript SDK	以编程方式调用 API 的客户端／模型适配器	JavaScript
浏览器扩展	面向零售网站的浏览器提取和 QuickCatch 流程	扩展

已安装扩展对现有网站的支持并不意味着拥有对所有网站的全面权限。PR #75 提议了一种范围更广的选择加入式集成。

定价与托管

开源代码采用 MIT 许可证。托管 API 提供匿名免费读取层，以及 Builder（$39/mo）、Pro（$99/mo）和 Reseller（$299/mo）。我们通过 Managed 提供范围明确的 Agent 就绪服务，设置费用起价为 $499；后续工作另行报价。

如需自行控制部署，请参阅自托管。托管服务权益和提供商 OAuth 连接与开源许可证相互独立。

参与贡献

我们需要的是可运行的集成和测试，而非未经证实的“网站已适配 Agent”之类声明。适合作为首次贡献的内容包括：带测试样例的只读公开格式适配器、浏览器兼容性示例、协议边缘情况测试，以及更完善的错误处理、安全性或无障碍支持。

请从 CONTRIBUTING.md、适配器契约或适配器需求列表开始。请尽可能在拉取请求中附上可执行的测试或复现步骤。

node adapters/_test/run.mjs
cd worker && npm install && npm run verify
# From the repository root:
node --test cli/*.test.mjs

有问题或发现 Bug？提交 issue。如果此工具包为你节省了时间，为仓库点个 Star 能帮助更多开发者发现它。

许可证：MIT。与浏览器供应商或本文提及其 API 的公司均无关联。