← 返回目录

Octocode MCP - AI Context Platform

社区

面向 AI 代理的证据优先代码研究平台

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 60 / 438
Stars: ★ 950 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20.12+
凭据: 可选 API Key
许可证: MIT
最近提交: 57 天前
工具数: 12

64FMRS · C

资料显示该服务器是一个 active 状态的 stdio MCP 服务，版本为 16.2.0，采用 MIT 许可证，并提供 GitHub、本地文件系统、npm、LSP 与 OQL 代码研究能力。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

14/20

维护活跃度

12/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 清单声明了 stdio 传输、npm 包和 12 个工具，README 也描述了初始化与工具目录，说明正常路径看起来可行。但清单中的仓库地址、包名 octocode-mcp 与 README 主推的 @octocodeai/mcp 存在不一致，且提供的材料没有 CI、提交记录、测试或 MCP 握手验证证据，因此扣分；按静态校准不超过 12 分。
安全与权限 14/20: 材料显示 GitHub 凭据通过环境变量、gh CLI 或加密存储处理，GITHUB_TOKEN 标记为 secret；还描述了本地路径限制、敏感文件阻断、输入输出扫描、命令参数白名单，以及 MCP 克隆功能默认关闭。这些证据支持较好的安全设计。但这些主要是 README 自述，未提供可审计的实现、权限确认流程或真实数据流测试；GitHub 所需 repo、read:user、read:org 权限也较宽，因此未给满分。
维护活跃度 12/20: 项目标注为未归档，提供 MIT 许可证、当前版本 16.2.0、明确的 GitHub 仓库和较完整的文档目录，表明存在维护与更新路径。可是材料没有提交频率、发布历史、依赖更新、漏洞响应渠道或维护者治理信息；开放 issue 数量和 stars 仅作为发现信号，不能加分，因此只能给中等分数。
文档质量 15/20: README 覆盖 CLI 与 MCP 安装、多个客户端配置、认证方式、工具用途、配置优先级、路径和克隆开关、语言支持、安全模型、架构、文档索引及故障排查，并提供了大量示例。扣分点是清单与 README 的包名和仓库信息不一致，完整工具 schema、限制和成本信息未在给定材料中展开，且若干安全与能力说明无法通过源文件审计；因此不是满分。
安装易用性 13/20: 提供 npx 启动方式、Claude Code 和多个主流客户端的配置示例，GitHub 认证也有 CLI、OAuth 和环境变量选项，整体步骤较清晰。扣分来自包名/版本路径不一致、主要安装示例使用 latest、运行时与平台前置条件说明不完整，以及没有真实连接或 CI 测试证据；静态校准下不超过 15 分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要证据驱动代码研究的 AI 代理和开发者。
需要同时分析本地工作区与 GitHub 仓库的团队。
需要语义导航、结构搜索和紧凑上下文的代码审查或重构工作。

不适合谁

只需要浏览器自动化、云存储、协作或数据库操作的用户。
不希望授予本地工作区访问权限或 GitHub 访问权限的环境。
需要非 stdio 传输方式的客户端。

所需权限

本地工具可访问配置允许的工作区路径；默认本地工具开启。
GitHub 相关工具需要 GitHub 认证；个人访问令牌支持 repo、read:user 和 read:org 范围。
如启用克隆功能，服务器需要访问 GitHub 仓库并使用本地缓存。

风险与副作用

本地工具可能读取允许路径中的代码和文件；服务器会阻止多类敏感文件和目录。
GitHub 令牌属于敏感凭据，应通过环境变量或安全凭据管理提供，不能提交到版本控制。
敏感信息扫描和自动脱敏可能影响返回内容的完整性。
启用仓库克隆会增加本地缓存和外部仓库数据处理范围。

安装接入

准备工作

运行环境：Node.js 20.12+

GITHUB_TOKEN 可选密钥 GitHub 个人访问令牌，在 github.com/settings/tokens 创建，需要 repo、read:user、read:org 权限；也可通过 npx octocode auth login 或 gh auth login 代替。

OCTOCODE_TOKEN 可选密钥 GitHub 令牌，与 GH_TOKEN/GITHUB_TOKEN 同级，按此优先顺序解析，设置在环境变量中即可。

GH_TOKEN 可选密钥 GitHub CLI 或自定义令牌环境变量，作为 OCTOCODE_TOKEN 之后的备选令牌来源。

其他可选配置项（5 个）

ENABLE_LOCAL 可选设为 true 可在 MCP 服务器上启用本地文件与 LSP 工具（MCP 默认关闭）。

ENABLE_CLONE 可选设为 true 可在 MCP 服务器上启用 ghCloneRepo 克隆工具（MCP 默认关闭）。

WORKSPACE_ROOT 可选解析相对本地路径的工作区根目录，默认为 cwd。

ALLOWED_PATHS 可选额外的本地访问路径白名单，默认仅允许主目录。

GITHUB_API_URL 可选 GitHub API 端点，默认 https://api.github.com，GitHub Enterprise 用 /api/v3。

使用 npx octocode-mcp@latest 以 stdio 启动服务器，并将提供的 JSON 配置加入 MCP 客户端。GitHub 工具需要认证；可使用 npx octocode auth login、GitHub CLI，或设置 GITHUB_TOKEN、GH_TOKEN 或 OCTOCODE_TOKEN。MCP 中的仓库克隆工具默认关闭，如需使用需设置 ENABLE_CLONE=true。

.cursor/mcp.json

{"octocode":{"command":"npx","type":"stdio","args":["octocode-mcp@latest"]}}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "octocode": {
    "command": "npx",
    "type": "stdio",
    "args": [
      "octocode-mcp@latest"
    ]
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

安装后运行 npx octocode status 确认令牌来源，然后在客户端工具列表中应能看到 ghSearchCode、ghGetFileContent 等工具；向助手提问『搜索我当前目录中包含 authenticate 的代码』可验证本地/远程检索通路。

常见排障

使用 npx octocode status 检查认证和设置。
GitHub 查询失败时检查 Octocode 登录状态、GitHub CLI 认证或令牌环境变量。
本地读取失败时检查 WORKSPACE_ROOT、ALLOWED_PATHS 和路径权限。
克隆工具不可用时检查是否设置 ENABLE_CLONE=true。
遇到 Node.js 问题时运行 npx node-doctor check --json。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 ghSearchCode 在 facebook/react 仓库里搜索 useCallback 的用法，返回文件和行号
读取 vercel/next.js 仓库中 package. 的内容，只要 dependencies 部分
查看 octocat/Hello-World 的仓库目录结构
在 npm 上搜索一个处理 YAML 解析的包，并告诉我它的源码仓库地址

工具能力 12

ghSearchCode 只读

按所有者、仓库、路径、文件名、扩展名和匹配条件搜索 GitHub 代码与路径。

ghGetFileContent 只读

读取 GitHub 文件或指定区域，支持完整文件、行范围、匹配片段和分页。

ghViewRepoStructure 只读

浏览 GitHub 仓库目录树。

ghSearchRepos 只读

按关键词、所有者、主题、语言、星标、分支、大小、日期、许可证和可见性发现仓库。

ghHistoryResearch

搜索拉取请求历史，或深入读取单个拉取请求的文件、补丁、评论、评审和提交。

localSearchCode 只读

搜索本地代码或文本，也可执行 AST 结构查询。

localViewStructure 只读

浏览本地目录树，支持深度、过滤和分页。

localFindFiles 只读

按名称、路径、正则表达式、扩展名、大小、时间、权限或类型查找本地文件和目录。

展开其余 4 个工具

localGetFileContent 只读

读取本地文件或指定区域，支持精确片段、匹配字符串、行范围和分页。

npmSearch 只读

查找 npm 包并返回元数据及其 GitHub 源代码仓库。

lspGetSemantics 只读

通过 LSP 获取定义、引用、调用者、被调用者、调用层级、悬停信息、符号和类型关系等语义信息。

oqlSearch

对代码、内容、结构、文件、语义、仓库、包、拉取请求、提交、差异和研究图等目标执行 OQL 查询。

使用场景

在修改代码前搜索并核实本地或 GitHub 代码证据。

通过 AST 和 LSP 追踪代码结构、定义、引用及调用关系。

研究 GitHub 拉取请求、提交、npm 包和跨仓库实现模式。

为大型文件生成压缩、骨架化或分页后的上下文。

支持客户端

Cursor

VS Code

VS Code Insiders

Windsurf

Kiro

Goose

LM Studio

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

Octocode MCP 通过 stdio 为 AI 助手提供代码研究工具，支持 GitHub 与本地代码搜索、目录结构浏览、精确文件读取、AST 结构匹配、LSP 语义导航、npm 包搜索、拉取请求历史研究和 OQL 查询。它与 CLI 共用基于 Rust 的引擎，可进行代码压缩、结构提取、分页和敏感信息扫描。