CodeAgent MCP 是托管的 Model Context Protocol(MCP)服务器,让 Claude、Cursor 和 Windsurf 等 LLM 能够理解、浏览和查询任何公开的 GitHub 仓库。它克隆仓库,用 tree-sitter 解析,通过 Hugging Face Serverless API 或 FastEmbed 生成向量嵌入,并通过 Streamable HTTP 提供代码智能工具。 该服务器以免费的托管后端充当 LLM 的“眼睛和双手”。用户可以让 LLM 为某个 GitHub 仓库建立索引;LLM 会调用 index_github_repo 工具。随后 CodeAgent 会进行浅克隆,用 tree-sitter 并行把每个文件解析为抽象语法树,通过 Hugging Face API 生成云端向量嵌入,并通过一次批量事务把符号和导入存入 PostgreSQL 数据库。 建立索引后,LLM 可以生成架构图、执行语义向量搜索并浏览代码库。可用的 MCP 工具包括 index_github_repo、generate_architecture_diagram、semantic_search_tool、search_symbols、list_all_symbols、find_callers_tool、read_code 和 get_imports。该项目以 MIT 许可开源,可自托管,也可通过公共托管端点使用。
团队用 CodeAgent 为公开的 GitHub 仓库建立索引,并获得用于后续查询的唯一 session_id。
团队用 CodeAgent 生成仓库架构的 Mermaid.js 类图。
团队用 CodeAgent 按含义而非精确关键词匹配来搜索代码。
团队用 CodeAgent 按部分名称查找函数或类。
团队用 CodeAgent 按类型筛选并列出所有符号。
团队用 CodeAgent 查找某个函数在哪里被调用。
团队用 CodeAgent 从磁盘读取带行号的确切源代码行。
团队用 CodeAgent 列出为特定文件记录的所有导入。