Oss Autopilot

@oss-autopilot/mcp

适用于 OSS Autopilot 的 MCP 服务——将 PR 跟踪、问题发现和贡献管理作为 MCP 工具提供给任何兼容 MCP 的客户端。

提供的功能

功能	数量	描述
工具	30	daily、status、search、features、vet、vet-list、verify-issue、track、compliance-score、repo-vet、strategy、comments、post、claim、config、init、setup、check-setup、startup、dismiss、undismiss、move、state-show、state-sync、state-unlink、guidelines-list、guidelines-get、guidelines-store、guidelines-reset、guidelines-fetch-corpus
资源	6	oss://status、oss://config、oss://prs、oss://prs/shelved、oss://pr/{owner}/{repo}/{number}、oss://repo/{owner}/{repo}/guidelines
提示词	4	triage（PR 优先级排序）、respond-to-pr（起草回复）、find-issues（发现问题）、extract-learnings（根据过往 PR 反馈提炼每个仓库的指导建议）

支持 stdio（默认）和 Streamable HTTP 传输方式。

前置条件

• Node.js 22+
• 已完成身份验证的 GitHub CLI（gh auth login）

快速开始

# 1. Add the server to your MCP client (see config examples below)

# 2. From your MCP client, call the `init` tool once with your GitHub username
#    (this writes ~/.oss-autopilot/state.json).

# 3. Use the other tools — e.g. `daily` to check your PRs, `search` to find issues.

客户端配置

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "oss-autopilot": {
      "command": "npx",
      "args": ["@oss-autopilot/mcp@latest"]
    }
  }
}

Cursor

添加到项目配置或全局配置中的 .cursor/mcp.json：

{
  "mcpServers": {
    "oss-autopilot": {
      "command": "npx",
      "args": ["@oss-autopilot/mcp@latest"]
    }
  }
}

Codex CLI

codex mcp add oss -- npx @oss-autopilot/mcp@latest

Windsurf

添加到 Windsurf MCP 配置中：

{
  "mcpServers": {
    "oss-autopilot": {
      "command": "npx",
      "args": ["@oss-autopilot/mcp@latest"]
    }
  }
}

Streamable HTTP（任何客户端）

以 HTTP 模式而非 stdio 模式运行服务：

npx @oss-autopilot/mcp@latest --http --port 3001

服务将在 http://127.0.0.1:3001/mcp 监听并接受 POST 请求。

身份验证

HTTP 模式要求每个请求都携带 bearer token（stdio 模式则不需要——它会继承父进程的身份）。首次使用 --http 启动时，服务会生成一个随机的 32 字节令牌，并以 0600 权限写入 ~/.oss-autopilot/mcp.token。启动时会在 stderr 中记录令牌路径和“新生成”标记。

每个 HTTP 客户端都必须发送：

Authorization: Bearer <contents of ~/.oss-autopilot/mcp.token>

没有有效 Authorization 标头的请求会返回 401。根据 RFC 7235，Bearer 方案不区分大小写；令牌值本身则会通过恒定时间逐字节比较。带有非回环 Host 标头的请求会返回 403（防止 DNS 重绑定）。请求必须声明数值型 Content-Length，且不超过 1 MiB——缺失、非数值或超出限制的 Content-Length 值都会返回 413。

令牌会在重启后保留。如需轮换令牌，请删除该文件并重启——系统会生成新令牌。如需更改令牌存放位置（例如用于多用户或 CI 配置），请在启动服务前将 OSS_AUTOPILOT_MCP_TOKEN_PATH 设置为所需的绝对路径。

工具参考

工具	描述	只读
daily	运行每日 PR 监控检查并提供优先级摘要	否
status	显示当前 PR 跟踪状态	是
search	在 GitHub 上搜索可参与贡献的问题	是
features	在有 3 个或更多已合并 PR 的仓库中查找特定功能的机会（以关系为锚点）	是
vet	分析问题是否适合参与贡献	是
verify-issue	在评估前确定性地验证问题状态和关联 PR 的说法	是
vet-list	重新评估精选问题列表中的所有可用问题	否
track	检查 PR：只读元数据查询（不会跟踪或持久化任何内容）	是
compliance-score	根据 opensource.guide 最佳实践为 PR 评分（#1245）	是
repo-vet	计算 owner/repo 的仓库健康度评分标准（1–10 分 + 结论）（#1271）	是
strategy	按需生成贡献策略快照，通过 computeStrategy() 实现（#1243）	是
comments	获取并显示 PR 评论	是
post	在问题或 PR 上发表评论	否
claim	通过发表评论认领问题	否
config	获取或设置配置值	否
init	使用 GitHub 用户名初始化	否
setup	配置偏好（语言、兴趣）	否
check-setup	检查设置是否已完成	是
startup	运行启动检查（身份验证、状态、配置）	否
dismiss	从通知中忽略某个问题	否
undismiss	为已忽略的问题重新启用通知	否
move	在不同状态间移动 PR（待处理、等待中、搁置、自动）	否
state-show	显示当前状态持久化模式（本地或 Gist）和同步状态	是
state-sync	强制将当前状态推送到后端 Gist	否
state-unlink	断开与 Gist 持久化的连接并切换为仅本地模式	否
guidelines-list	列出已存储指南的仓库（本地模式下始终为空）	是
guidelines-get	读取从过往 PR 反馈中提取的仓库级学习指南	是
guidelines-store	持久化仓库级指南（上限为 8 KB；需要 Gist 模式）	否
guidelines-reset	为某个仓库的指南文件创建删除标记	否
guidelines-fetch-corpus	获取原始 PR 评论集，供主机的 extract-learnings 提示词使用	否

资源参考

资源 URI	描述
oss://status	PR 跟踪状态（缓存的本地状态）
oss://config	当前配置
oss://prs	上次每日摘要中的活跃未关闭 PR
oss://prs/shelved	已搁置的 PR
oss://pr/{owner}/{repo}/{number}	特定 PR 的详细信息
oss://repo/{owner}/{repo}/guidelines	仓库级学习指南（Markdown）

提示词参考

提示词	参数	描述
triage	none	获取每日摘要并生成按优先级排列的分诊列表
respond-to-pr	prUrl	获取 PR 评论和上下文，以便起草回复
find-issues	maxResults?	搜索并按可行性评分对问题排序
extract-learnings	repo、corpus、existingGuidelines?	从原始 PR 评论集中提炼持久的仓库级指导（#867）

程序化用法

也可以将该服务作为库导入和使用：

import { createServer } from '@oss-autopilot/mcp';

const server = createServer();
// Connect to your own transport

更多信息

完整文档请参阅主仓库 README，其中包括 Claude Code 插件、CLI 用法、仪表板和贡献指南。

许可证

MIT