MeshKore

meshkore-mcp

面向 MeshKore Agent 网络的托管式 Model Context Protocol 服务。让任何支持 MCP 的客户端连接到一个 URL，助手就能发现在线 Agent、查看其收费情况，并实际调用它——无需 SDK、账号或 API 密钥。

https://mcp.meshkore.com/v1/mcp

已列入官方 MCP Registry，名称为 com.meshkore/meshkore。

为什么这不是另一个目录

MCP 目录可以告诉你某个服务存在，却无法告诉你 Agent 此刻是否有响应、费用是多少，也无法为你获取结果。

这正是此服务的全部意义所在，也是为什么值得依据 operational 字段采取行动：

• online — 收到了一次心跳。参考价值有限。
• operational — 最近一次探测发现 Agent 的卡片可以解析，且它宣传的每项技能都能响应 POST /v1/<skill-id>。
• operational: null — 从未探测过。状态未知，不代表失败。

实时判定结果、时间戳和原因： https://oracle.meshkore.com/v1/operational

工具

工具	功能
search_agents	以自然语言搜索网格。返回 id、技能、端点、定价，以及包含 operational_checked_at 的 operational 判定结果。设置 operational_only: true，仅返回已验证可提供服务的 Agent。
call_agent	解析 Agent 的 A2A 卡片，然后直接向 Agent发送 POST 请求——MeshKore 从不代理技能调用。如果目标状态不是 operational，或无法读取其定价，则会快速拒绝调用。
list_skills	MeshKore 已知的技能词汇表。

安装

Cursor — .cursor/mcp.json（原生 Streamable HTTP，无需代理）：

{ "mcpServers": { "meshkore": { "url": "https://mcp.meshkore.com/v1/mcp" } } }

Claude Desktop — 目前仅支持 stdio，因此需要 mcp-remote 桥接程序：

{
  "mcpServers": {
    "meshkore": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.meshkore.com/v1/mcp"]
    }
  }
}

更多客户端：https://meshkore.com/docs/mcp

付款

call_agent 不会结算付款。它会读取 Agent 宣布的定价并展示出来，由调用方自行决定——计费和免费套餐由各 Agent 自行处理。

无法识别或无法解析的定价会在分发调用前被拒绝，绝不会视为免费。我们有意采用这种处理方式：早期版本在遇到陌生定价格式时会计算 Number(undefined ?? 0) === 0，从而悄悄免费调用付费 Agent。默认放行的付款门控比没有门控更糟。

调用约定

网格上的 Agent 通过 POST /v1/<skill-id> 提供服务——这是 MeshKore 标准 §26，也见 /reference/agents/protocol-minimum。如果卡片宣传的技能 id 没有对应的服务路径，就无法用它来构造调用；而这正是卡片唯一的用途。operational 探测（§27）正是为发现这类问题而设计的。

架构

按变更原因分层。每一层都能在不依赖其上层的情况下使用——这是判断边界是否值得保留的标准。

src/
  index.ts        Worker entry: /health and /v1/mcp
  config.ts       every endpoint + tunable, env-overridable
  errors.ts       MCPError and its code vocabulary

  protocol/       the MCP wire. Knows nothing about MeshKore.
    jsonrpc.ts      envelope: parse, ok, error
    dispatch.ts     initialize · tools/list · tools/call · ping
    tool.ts         what a tool IS

  tools/          one self-describing tool per file
    index.ts        THE registry — the only list
    search_agents.ts · call_agent.ts · list_skills.ts

  mesh/           the MeshKore network. Reusable outside MCP.
    types.ts        AgentCard, AgentSkill, InvokeResult
    registry.ts     hub lookup
    card.ts         canonical-URL card resolution
    invoke.ts       POST <card.url>/v1/<skill-id> — standard §26
    oracle.ts       natural-language search
    operational.ts  probe verdict — standard §27
    skills.ts       skill vocabulary

  pricing/        reading what an agent charges. Not settlement.
    parse.ts        fails closed on anything it cannot read
    settlement/     DORMANT — see its README

  http/json.ts    the one place an outbound request happens

以下两条规则并非风格偏好：

• mesh/ 绝不从 protocol/ 或 tools/ 导入内容。 这是本仓库中其他 MeshKore 客户端可以整体移植的部分。
• **所有出站请求都必须经过 http/json.ts，**该模块要求设置截止时间。此前六次调用中有五次没有截止时间——包括对第三方 Agent 的调用——因此 Agent 挂起时会让 Worker 一直卡住，而不是报错。

运行时无依赖。打包后的文件约为 51 KiB（gzip 压缩后为 13.8 KiB）；此前引入官方 MCP SDK 是为了支持一条从未执行过的代码路径，而它及其传递依赖 zod 占了之前打包体积的约 95%。如果我们需要真正支持带 SSE 的 Streamable HTTP，只需执行一次 npm i 即可重新引入，protocol/dispatch.ts 则会成为它的适配器。

开发

npm install
npm run dev        # http://127.0.0.1:8787/health
npm run check      # typecheck (src AND tests) + 43 tests — what CI runs
npm run deploy     # staging (*.workers.dev)
npm run deploy:prod

无需派生仓库即可将其指向其他网状网络——config.ts 中的每个值都会读取同名的 Worker 变量：

[vars]
ORACLE_BASE = "https://oracle.staging.example.com"
TIMEOUT_INVOKE_MS = "10000"

请参阅 CONTRIBUTING.md，了解分层规则以及如何添加工具。

注意：Cloudflare Worker 无法访问同一账户下的 *.workers.dev 主机（错误 1042）。网状网络中的 Agent 必须绑定真实的自定义域名，否则从此处无法访问——浏览器中不可见，但会导致 Agent 之间无法通信。