适合谁
- 需要让 AI 理解本地或远程代码库的开发者。
- 需要控制令牌数量和文件范围的代码分析流程。
- 使用 Claude Desktop、VS Code、Cline、Cursor 或 Claude Code 的用户。
R
67FMRS · C
资料显示 Repomix 是其上游项目提供的 MCP 服务器，采用 stdio 启动方式，提供本地与远程代码库打包、输出读取与搜索以及受安全检查保护的文件系统读取能力。资料未说明身份认证、写入能力或私有仓库支持。
Repomix 是一个命令行工具和 MCP 服务器，可将本地或远程 GitHub 代码库打包为集中式输出，供 AI 助手进行代码分析。它支持 XML、Markdown、JSON 和纯文本格式，并提供压缩、令牌统计、文件筛选、Git 日志与差异等功能。
工具能力
pack_codebase
将本地代码目录打包为集中式 XML 文件。
attach_packed_output
载入已有的 Repomix 打包输出文件。
pack_remote_repository
获取、克隆并打包 GitHub 代码库。
read_repomix_output
读取 Repomix 输出文件，可按行范围读取。
grep_repomix_output
使用 JavaScript 正则表达式搜索 Repomix 输出。
file_system_read_file
读取本地文件，并执行敏感信息安全检查。
file_system_read_directory
列出本地目录内容。
安装接入
将以下配置添加到支持 MCP 的客户端配置中，然后启动 Repomix MCP 服务器：命令为 npx，参数为 -y repomix --mcp。也可使用 Docker 运行 ghcr.io/yamadashy/repomix。
claude_desktop_config.json
{"mcpServers":{"repomix":{"command":"npx","args":["-y","repomix","--mcp"]}}}
选型与风险
不适合谁
- 需要数据库、云存储或浏览器自动化能力的用户。
- 需要直接修改代码库或执行通用写操作的流程。
- 需要明确身份认证、远程私有仓库访问或其他未在资料中说明能力的用户。
所需权限
- 读取指定的本地目录和文件。
- 获取、克隆和处理指定的 GitHub 远程仓库。
- 访问已有的 Repomix 输出文件。
- 执行 Secretlint 敏感信息检查；远程配置默认不加载，除非明确信任。
风险与副作用
- 打包内容可能包含敏感信息；虽然提供 Secretlint 检查，仍应审查输出后再提交给 AI 工具。
- 远程仓库配置默认不受信任；启用远程配置信任可能运行配置中的外部处理命令。
- 大型代码库可能超过 AI 工具的文件大小或上下文限制，需要筛选、压缩或拆分输出。
常见排障
- 确认客户端使用 npx -y repomix --mcp，或检查 Docker 命令是否可用。
- 确认传入本地路径是绝对路径，并且目标目录或输出文件存在。
- 检查 .gitignore、.ignore、.repomixignore 和 include/ignore 模式是否排除了目标文件。
- 处理远程仓库时，检查仓库地址、分支或提交标识，并确认远程配置信任设置。
使用场景
将代码库准备为 AI 代码审查、重构、文档生成和测试生成的上下文。
按模式筛选、压缩或搜索大型代码库。
直接分析远程 GitHub 仓库。
读取已有的打包输出并进行增量检索。
支持客户端
Claude Desktop完整支持
VS Code完整支持
Cline完整支持
Cursor完整支持
Claude Code完整支持