octocode-mcp
证据优先的代码研究平台，面向AI代理和开发者
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：octocode-mcp。 它的用途是：证据优先的代码研究平台，面向AI代理和开发者 完整的 Skill 内容见：https://321skill.com/skills/octocode-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用Octocode搜索项目中所有使用了React.useEffect的组件，并列出它们的依赖数组'，AI会调用Octocode的搜索和AST分析工具，返回相关文件路径和代码片段，让你快速检查依赖完整性。
介绍
Octocode 是一个专为 AI 代理和开发者打造的代码研究平台，以“证据优先”为核心理念。它整合了本地工作区（通过 ripgrep、AST 搜索、树结构、精确读取、LSP）和外部来源（GitHub 仓库、PR、npm 包）的代码搜索能力，底层基于 Rust 引擎，能够快速、高效地返回结果，尤其适合大型代码库。它既可作为 CLI 工具在终端使用，也可作为 MCP 服务器（Model Context Protocol）集成到支持 MCP 的 AI 工具中（如 Cursor、VS Code、Claude、Trae 等），让 AI 代理能够直接搜索、阅读、分析代码。
使用 Octocode 非常简单：只需运行 npx @octocodeai/mcp@latest 即可启动 MCP 服务器。如需访问私有仓库，可使用 npx octocode auth login 进行 GitHub 认证。它提供了 12 个工具，覆盖代码搜索、文件读取、AST 解析、符号查找、引用查询等，所有工具在 CLI 和 MCP 接口下行为一致，无需切换心智模型。
Octocode 适合全栈开发者、后端工程师、前端开发者、智能体开发者以及数据分析师。当你需要快速理解陌生代码库、排查 Bug 根因、审查 AI 生成的代码是否合理、或者进行跨仓库的代码搜索时，Octocode 可以显著提升效率。它尤其适合在大型 monorepo 中工作，或者需要同时查询本地和 GitHub 上多个仓库的场景。
使用建议：优先通过 MCP 集成到 AI 编辑器中，让 AI 代理自动调用搜索工具；注意 GitHub 认证可提升 API 速率限制，对于私有仓库是必须的；由于工具设计为只读，不适合直接修改代码或执行构建命令。
核心特点
与 ripgrep、grep 等传统搜索工具相比，Octocode 专为 AI 代理设计，支持 AST 搜索、LSP 精确跳转、树结构展示，并整合了 GitHub/PR/npm 外部来源，所有结果经过 token 优化，适合作为 AI 的代码上下文。
注意事项
只支持代码搜索和读取，不支持直接修改代码；对于非代码文件（如图片、PDF）搜索能力有限。
常见问题
如何安装 Octocode MCP 服务器？
运行 `npx @octocodeai/mcp@latest` 即可启动，无需全局安装。支持 Cursor、VS Code、Windsurf、Kiro、Goose 等的一键安装链接，详见 README。
Octocode 支持私有 GitHub 仓库吗？
支持。需要先运行 `npx octocode auth login` 进行 GitHub 认证，之后即可搜索私有仓库，并享受更高的 API 速率限制。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/octocode-mcp/raw/index.md 读取 octocode-mcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/octocode-mcp/raw/index.md（查看排版版本）