queueboard

queueboard

queueboard 是 FeatureJet 托管 MCP 服务的一个轻量本地桥接服务，该服务为产品团队提供反馈看板： 用户可以在看板上发布想法和需求、投票 并发表评论，团队则处理排序后的队列、 发布更新日志并查看看板分析数据。

该桥接服务本身不保存任何反馈数据。它会在本地提供 上游服务的工具列表，与从在线端点 捕获的内容完全一致，并将每次工具调用 转发到上游，原样返回结果。大多数操作 会写入调用者自己的工作区——看板、帖子和评论都可以创建和编辑， Agent 可以从工作队列中认领帖子，附加 证据，并提出状态变更建议，供所有者 确认。

工具

看板：

• list_boards - 调用者的密钥可访问的所有看板。 无参数。
• get_board - 按 slug 获取一个看板。必填：slug。
• create_board - 创建一个新的草稿看板。 必填：name、slug。可选：description。
• publish_board - 将看板发布到其公开 URL。 必填：slug。上游默认禁用此功能；如果 未启用，所有者需从控制面板发布。
• unpublish_board - 将看板恢复为草稿，使其 公开 URL 不再提供内容。必填：slug。

帖子、投票和评论：

• list_posts - 列出看板上的帖子，可按 status、搜索文本 q 或 tag 筛选， 并使用 limit 和 offset 分页。必填：slug。
• get_post - 完整获取一个帖子。必填：slug、 post_id。
• create_post - 在看板上创建一个新帖子。必填： slug、title。可选：body、status、tags。
• update_post - 更改帖子中可变的字段，例如 title、body、status、tags、pinned 和 queue_rank（排名设为 null 会取消该帖子的排名）。 必填：slug、post_id。
• delete_post - 通过开发者 API 隐藏帖子。 必填：slug、post_id。
• list_votes - 获取帖子的投票元数据。必填： slug、post_id。
• list_comments - 列出帖子的评论。必填： slug、post_id。
• create_comment - 以看板团队的身份发表评论， 可通过 parent_comment_id 回复评论。必填： slug、post_id、body。

Agent 工作队列：

• get_queue - 获取所有者整理的构建顺序中，排名最高且未被认领的帖子：先列出 已排名的帖子，再列出按投票数排序的未排名 计划中帖子。必填：slug。可选：limit。
• claim_post - 开始处理前，以原子方式认领帖子， 确保两个 Agent 不会同时构建同一项内容。 必填：slug、post_id。可选：ttl_seconds （默认值为 3600，最大值为 86400）和 agent_label。
• release_post - 释放认领，以便其他 Agent 认领该帖子。必填：slug、post_id。
• add_evidence - 附加实现证据， 投票者可在帖子页面上查看。必填：slug、 post_id、kind（branch、commit、pr、 transcript 或 url）和 ref。可选：label、 action_key。
• propose_status - 提议变更状态 （open、planned、in_progress、shipped 或 declined），供看板所有者确认；在人工确认前， 公开内容不会发生变化。必填： slug、post_id、status。可选：note、 action_key。

读取：

• get_changelog - 获取看板上已发布的帖子。 必填：slug。
• get_analytics - 获取看板的只读分析数据， 可按 period 指定周期。必填：slug。
• whoami - 列出调用者的密钥可访问的看板， 以确认该密钥。无参数。
• ping - 检查调用者的密钥能否访问 MCP 和 FeatureJet API。 无参数。

配置

• FEATUREJET_MCP_URL（可选）- 覆盖上游端点。默认值为 https://mcp.featurejet.com/mcp。（此覆盖挂钩是本次重建中自行标注的内容。）
• FEATUREJET_API_KEY（可选）- 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头。未设置时，不会发送认证标头。（此转发机制也是本次重建中自行标注的内容；原始界面是在未提供密钥的情况下采集的，注册表记录则声明 Authorization 标头是传递密钥的方式。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo name queueboard），再发送 notifications/initialized 通知，最后发送携带调用方原样参数的 tools/call 请求。当上游通过 initialize 返回 Mcp-Session-Id 标头时，该值会随会话后续的每个请求一起发送；此会话会在整个进程运行期间复用。回复可能是普通 JSON，也可能是服务器发送事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志。失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应或无法完成的请求——会作为 isError 结果返回，文本以 queueboard error: 开头（此错误呈现方式是本次重建中自行标注的内容）。

CLI

每个工具也可作为子命令调用，并接受一个 JSON 参数字符串（无参数的工具可省略）：

npx @reneturcios/queueboard list_boards
npx @reneturcios/queueboard get_board '{"slug":"ideas"}'
npx @reneturcios/queueboard create_post '{"slug":"ideas","title":"Dark mode"}'
npx @reneturcios/queueboard get_queue '{"slug":"ideas"}'
npx @reneturcios/queueboard claim_post '{"slug":"ideas","post_id":42}'
npx @reneturcios/queueboard --version

退出代码：成功时为 0，结果带有 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/queueboard mcp

MCP 客户端配置：

{
  "mcpServers": {
    "queueboard": {
      "command": "npx",
      "args": ["-y", "@reneturcios/queueboard", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/queueboard
docker run --rm ghcr.io/cloudcorprecords/queueboard --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数则会正常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT - 参见 LICENSE。