适合谁
- 需要证据驱动代码研究的 AI 代理和开发者。
- 需要同时分析本地工作区与 GitHub 仓库的团队。
- 需要语义导航、结构搜索和紧凑上下文的代码审查或重构工作。
O
64FMRS · C
资料显示该服务器是一个 active 状态的 stdio MCP 服务，版本为 16.2.0，采用 MIT 许可证，并提供 GitHub、本地文件系统、npm、LSP 与 OQL 代码研究能力。
Octocode MCP 通过 stdio 为 AI 助手提供代码研究工具，支持 GitHub 与本地代码搜索、目录结构浏览、精确文件读取、AST 结构匹配、LSP 语义导航、npm 包搜索、拉取请求历史研究和 OQL 查询。它与 CLI 共用基于 Rust 的引擎，可进行代码压缩、结构提取、分页和敏感信息扫描。
工具能力
ghSearchCode
按所有者、仓库、路径、文件名、扩展名和匹配条件搜索 GitHub 代码与路径。
ghGetFileContent
读取 GitHub 文件或指定区域，支持完整文件、行范围、匹配片段和分页。
ghViewRepoStructure
浏览 GitHub 仓库目录树。
ghSearchRepos
按关键词、所有者、主题、语言、星标、分支、大小、日期、许可证和可见性发现仓库。
ghHistoryResearch
搜索拉取请求历史，或深入读取单个拉取请求的文件、补丁、评论、评审和提交。
localSearchCode
搜索本地代码或文本，也可执行 AST 结构查询。
localViewStructure
浏览本地目录树，支持深度、过滤和分页。
localFindFiles
按名称、路径、正则表达式、扩展名、大小、时间、权限或类型查找本地文件和目录。
localGetFileContent
读取本地文件或指定区域，支持精确片段、匹配字符串、行范围和分页。
npmSearch
查找 npm 包并返回元数据及其 GitHub 源代码仓库。
lspGetSemantics
通过 LSP 获取定义、引用、调用者、被调用者、调用层级、悬停信息、符号和类型关系等语义信息。
oqlSearch
对代码、内容、结构、文件、语义、仓库、包、拉取请求、提交、差异和研究图等目标执行 OQL 查询。
安装接入
使用 npx octocode-mcp@latest 以 stdio 启动服务器，并将提供的 JSON 配置加入 MCP 客户端。GitHub 工具需要认证；可使用 npx octocode auth login、GitHub CLI，或设置 GITHUB_TOKEN、GH_TOKEN 或 OCTOCODE_TOKEN。MCP 中的仓库克隆工具默认关闭，如需使用需设置 ENABLE_CLONE=true。
claude_desktop_config.json
{"octocode":{"command":"npx","type":"stdio","args":["octocode-mcp@latest"]}}
选型与风险
不适合谁
- 只需要浏览器自动化、云存储、协作或数据库操作的用户。
- 不希望授予本地工作区访问权限或 GitHub 访问权限的环境。
- 需要非 stdio 传输方式的客户端。
所需权限
- 本地工具可访问配置允许的工作区路径；默认本地工具开启。
- GitHub 相关工具需要 GitHub 认证；个人访问令牌支持 repo、read:user 和 read:org 范围。
- 如启用克隆功能，服务器需要访问 GitHub 仓库并使用本地缓存。
风险与副作用
- 本地工具可能读取允许路径中的代码和文件；服务器会阻止多类敏感文件和目录。
- GitHub 令牌属于敏感凭据，应通过环境变量或安全凭据管理提供，不能提交到版本控制。
- 敏感信息扫描和自动脱敏可能影响返回内容的完整性。
- 启用仓库克隆会增加本地缓存和外部仓库数据处理范围。
常见排障
- 使用 npx octocode status 检查认证和设置。
- GitHub 查询失败时检查 Octocode 登录状态、GitHub CLI 认证或令牌环境变量。
- 本地读取失败时检查 WORKSPACE_ROOT、ALLOWED_PATHS 和路径权限。
- 克隆工具不可用时检查是否设置 ENABLE_CLONE=true。
- 遇到 Node.js 问题时运行 npx node-doctor check --json。
使用场景
在修改代码前搜索并核实本地或 GitHub 代码证据。
通过 AST 和 LSP 追踪代码结构、定义、引用及调用关系。
研究 GitHub 拉取请求、提交、npm 包和跨仓库实现模式。
为大型文件生成压缩、骨架化或分页后的上下文。
支持客户端
Cursor完整支持
VS Code完整支持
VS Code Insiders完整支持
Windsurf完整支持
Kiro完整支持
Goose完整支持
LM Studio完整支持
Claude Code完整支持