Concierge Agent Protocol

JavaScript 版 Concierge Agent Protocol

为 CAP 前门两端提供的包。@conciergeprotocol/client 用于访问前门。@conciergeprotocol/mcp 将该客户端作为三个工具公开，让 Claude、Cursor 和其他 MCP 主机能够向公司提问。@conciergeprotocol/server 使用一个 answer 函数运行前门。@conciergeprotocol/agent 根据模型、llms.txt 文件和 MCP 工具构建此函数。

协议见 conciergeprotocol.org。公司会发布 agent.txt，但不会为访客发布 MCP 服务。如果有 MCP 服务，它会留在前门后面。

安装

• @conciergeprotocol/client
• @conciergeprotocol/mcp
• @conciergeprotocol/server
• @conciergeprotocol/agent

npm install @conciergeprotocol/client

MCP 服务是一个命令。请先安装，或像下面的代码块中那样使用 npx 运行。

npm install @conciergeprotocol/mcp

客户端

import { createClient } from '@conciergeprotocol/client'

const cap = createClient({ from: 'agent:my-assistant' })

const answer = await cap.ask('example.com', 'Do you have a free plan?')
console.log(answer.reply)

后续提问只需发送新问题：

const thread = cap.thread('example.com')
await thread.ask('What do you sell?')
const price = await thread.ask('How much is the cheapest paid plan?')

如果网站没有前门，discover 会返回 null。遇到同样的情况，ask 会抛出 NoDoorError，此时应改为浏览网站。

ask 最多等待两分钟。如果公司仍在作答，消息会带有 status: 'working'，且没有 reply。可再次调用 get 读取消息。

账户相关问题使用 login。客户端会打开公司的页面，而 finishLogin 会保存令牌，供下一次 ask 使用。令牌会保存在传递给 createClient 的令牌存储中。

MCP

Cursor、Claude Desktop 和 VS Code 使用相同的代码块。在 VS Code 中，将其放入 .vscode/mcp.json；在 Cursor 和 Claude Desktop 中，将其放入 MCP 设置文件。

{
  "mcpServers": {
    "cap": {
      "command": "npx",
      "args": ["-y", "@conciergeprotocol/mcp"],
      "env": { "CAP_FROM": "agent:my-assistant" }
    }
  }
}

CAP_FROM 默认值为 agent:cap-mcp。这些工具分别是 cap_discover、cap_ask 和 cap_check。该服务在 MCP 注册表中的条目为 io.github.conciergeprotocol/mcp。cap_ask 会等待 60 秒。如果公司仍在作答，它会返回消息 ID，模型会改为调用 cap_check，而不是猜测答案。

运行前门

answer 是公司自己的函数。服务会维护对话线程，防止一个调用者看到另一个调用者的回复，并执行每日消息上限。

import { createAnswer } from '@conciergeprotocol/agent'
import { createCapServer } from '@conciergeprotocol/server'

const answer = await createAnswer({
  model: 'anthropic/claude-sonnet-4.5',
  instructions: 'You answer for Harbor Goods. Link to the page.',
  sources: [{ type: 'llms', url: 'https://harborgoods.example/llms.txt' }],
})

const cap = await createCapServer({
  agent: { name: 'Harbor Goods', chat: 'https://harborgoods.example/chat' },
  answer,
})

await cap.listen(8088)

已经有机器人的公司可以跳过 agent 包，传入自己的 answer。npx cap-check http://127.0.0.1:8088 会读取 agent.txt、提问一次，并检查第二个调用者是否无法读取该回复。

发布

添加 changeset，然后合并到 main：

bun run changeset

Package Checks 会在每次推送时运行。在 main 上通过检查后，发布工作流会创建版本拉取请求，或发布这两个包并为版本打标签。这两个包使用相同的版本。npm 发布成功后，同一工作流会将该服务列入 MCP 注册表。仓库需要配置 NPM_TOKEN 密钥。

许可证

Apache 2.0