AgentShopping Intent Catalog

agentshopping-mcp

一个 MCP 服务，可将 AgentShopping 的买家意向目录提供给任何兼容 MCP 的 Agent。

它是只读的。不持有资金、不下单，也不会写入任何内容。它返回带日期和来源的事实，并会明确说明自己不知道什么。

两种使用方式

1. 远程端点（推荐，无需安装）

https://agentshopping.org/mcp

MCP Streamable HTTP。将任何 MCP 客户端指向该 URL：

{
  "mcpServers": {
    "agentshopping": {
      "url": "https://agentshopping.org/mcp"
    }
  }
}

此端点已列入官方 MCP Registry：

字段	值
名称	org.agentshopping/intent-catalog
版本	0.1.1
命名空间	agentshopping.org 的反向 DNS 域名（HTTP authentication）
状态	active
发布日期	2026-11-08T13:47:55Z
来源	https://github.com/wken2238-byte/agentshopping-mcp

自行验证：

curl 'https://registry.modelcontextprotocol.io/v0.1/servers?search=agentshopping'

2. 本地 stdio 服务（在你的机器上运行）

node src/index.js

{
  "mcpServers": {
    "agentshopping": {
      "command": "node",
      "args": ["/absolute/path/to/agentshopping-mcp/src/index.js"]
    }
  }
}

尚未发布到 npm。 agentshopping-mcp 包名已被预留，但该包尚未发布到注册表，因此 npm install -g agentshopping-mcp 目前无法使用。在此之前，请按上面的说明从检出目录运行。

将它指向其他目录

stdio 服务会读取 AGENTSHOPPING_API_BASE（如果已设置），否则使用 https://agentshopping.org。可用它来连接可自托管或镜像的目录：

{
  "mcpServers": {
    "agentshopping": {
      "command": "node",
      "args": ["/path/to/agentshopping-mcp/src/index.js"],
      "env": { "AGENTSHOPPING_API_BASE": "https://your-mirror.example" }
    }
  }
}

工具

工具	返回内容
list_intents	100 条买家交易意向及其供给状态
get_intent	一条意向所需的上下文、决策因素和如实说明的供给状态
list_offers	供给目录，包含带日期的已验证事实和明确标注的未验证字段
match_workload	针对工作负载给出确定且可解释的匹配或拒绝结果

match_workload 会返回匹配结果，也会返回附有原因的拒绝结果。它不会排序、评分或宣布某个选项是“最佳”选项——拒绝也是一项正式结果，而非失败。

如实说明的局限

• 100 条意向中有 99 条没有经过验证的供给合作方。 每条响应都会明确说明这一点。
• 不会声称任何价格、规格、供应商或可用性。 未知字段会列在 unverified_fields 下，而不会猜测。
• 意向排序是编辑安排，并非经测量得出的需求排序。
• 目前只有一个供给合作方。这只是协议骨架，并非市场。
• 跳转至服务提供方的链接需要用户知情后手动点击。不自动重定向，也不使用 iframe。
• 列入注册表不代表有人正在使用它，只表示它可以被找到。

自行运行远程端点

已部署的端点是 src/http-server.py——仅使用 Python 3 标准库，无依赖：

MCP_PORT=8787 MCP_DATA_ROOT=/path/to/site python3 src/http-server.py

它遵循以下设计约束：

• 仅绑定到 127.0.0.1。请将其部署在 TLS 反向代理之后。
• 从磁盘读取静态 JSON。不进行出站网络调用、不轮询，也不执行后台任务。
• 请求正文上限为 64 KB；路径使用允许列表并防止路径遍历。
• 使用线程，并限制并发数量及每个连接的超时时间，因此一个缓慢的客户端不会阻塞其他客户端。
• 在 systemd 下运行，设置 MemoryMax=64M 和 CPUQuota=10%。

src/http-server.cjs 是相同服务的 Node 版本，仅供参考。已部署的实例使用 Python 版本。

协议详情

• **远程：**通过 POST /mcp 使用 MCP Streamable HTTP。GET 返回 405——不会保持 SSE 流处于打开状态。
• **本地：**通过 stdin/stdout 使用以换行符分隔的 JSON-RPC（MCP stdio 传输）。日志仅写入 stderr。需要 Node.js >= 18。
• 支持的方法：initialize、ping、tools/list、tools/call、resources/list（空）、prompts/list（空）。通知会被忽略，不会收到响应。

手动测试

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_intent","arguments":{"id":"book-flight"}}}' \
  | node src/index.js

向注册表发布更改

npm i -g mcp-publisher
cd agentshopping-mcp
./publish.sh 0.1.1     # bumps the version in server.json, then publishes

publish.sh 使用 HTTP 身份验证进行身份验证——它使用本地 ECDSA P-384 密钥对质询进行签名，注册表会从 https://agentshopping.org/.well-known/mcp-registry-auth 获取公钥。无需任何人手动点击。

请注意，注册表自己的 JWT 仅有效 5 分钟，因此登录和发布步骤会紧接着执行，中间不留间隔。脚本会处理这些步骤，并在偶尔发生网络卡顿时重试。

完整的操作说明（包括如何生成证明文件和密钥对）请参阅 发布指引.md（中文）。

许可证

MIT——详见 LICENSE。