← 返回目录

Repomix

官方

将代码库打包成适合 AI 分析的格式。

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

分类: 开发工具第 26 / 438
Stars: ★ 28.9k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 8 天前
工具数: 7

67FMRS · C

资料显示 Repomix 是其上游项目提供的 MCP 服务器，采用 stdio 启动方式，提供本地与远程代码库打包、输出读取与搜索以及受安全检查保护的文件系统读取能力。资料未说明身份认证、写入能力或私有仓库支持。

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

可靠性

10/20

安全与权限

13/20

维护活跃度

14/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README声明了7个MCP工具及参数，启动方式和主要工作流清晰，正常路径看起来可行。但服务器manifest未缓存，未提供可核验的初始化/工具列表握手证据，也没有提交的、针对MCP关键路径的测试或错误行为证据；因此按静态审查保守扣分。
安全与权限 13/20: 证据显示使用Secretlint扫描敏感信息，远程配置默认不信任，并在交互终端要求确认；同时支持路径校验、忽略规则和只读式打包流程。但MCP可读取绝对路径、访问本地目录、克隆远程仓库，配置中的file processors可运行任意外部命令；未见完整权限边界、沙箱、网络范围或所有危险操作的确认机制，因此扣分。未发现提示中的安全红线。
维护活跃度 14/20: 项目未归档，拥有MIT许可证，并有大量公开使用信号、赞助入口、Discord和GitHub仓库作为维护渠道。可是提供的材料没有可核验的发布频率、提交活动、依赖更新、漏洞响应流程或明确版本支持政策；星标和问题数不能直接加分，因此仅给中上分。
文档质量 16/20: README覆盖CLI安装、MCP客户端配置、工具名称与参数、输出格式、过滤、压缩、远程仓库、限制条件和安全相关选项，示例较丰富。扣分点是manifest缺失，未提供认证/凭据模型、系统权限边界、故障排查、版本兼容性和可验证的实际工具行为；部分安全保证仅为文档声明。
安装易用性 14/20: 提供npx、全局包管理、Homebrew、Docker及VS Code、Cline、Cursor、Claude Desktop和Claude Code配置示例，主流客户端接入步骤相对明确。仍需用户准备Node/npm或Docker并手工配置，未说明运行时版本、平台差异、连接失败排查或握手验证；因此未给满分。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

需要让 AI 理解本地或远程代码库的开发者。
需要控制令牌数量和文件范围的代码分析流程。
使用 Claude Desktop、VS Code、Cline、Cursor 或 Claude Code 的用户。

不适合谁

需要数据库、云存储或浏览器自动化能力的用户。
需要直接修改代码库或执行通用写操作的流程。
需要明确身份认证、远程私有仓库访问或其他未在资料中说明能力的用户。

所需权限

读取指定的本地目录和文件。
获取、克隆和处理指定的 GitHub 远程仓库。
访问已有的 Repomix 输出文件。
执行 Secretlint 敏感信息检查；远程配置默认不加载，除非明确信任。

风险与副作用

打包内容可能包含敏感信息；虽然提供 Secretlint 检查，仍应审查输出后再提交给 AI 工具。
远程仓库配置默认不受信任；启用远程配置信任可能运行配置中的外部处理命令。
大型代码库可能超过 AI 工具的文件大小或上下文限制，需要筛选、压缩或拆分输出。

安装接入

准备工作

运行环境：Node.js · Docker

其他可选配置项（1 个）

REPOMIX_REMOTE_TRUST_CONFIG 可选设为 true 时允许加载远程仓库中的 repomix 配置文件（默认关闭以防不信任仓库执行代码），无需到外部获取。

将以下配置添加到支持 MCP 的客户端配置中，然后启动 Repomix MCP 服务器：命令为 npx，参数为 -y repomix --mcp。也可使用 Docker 运行 ghcr.io/yamadashy/repomix。

claude_desktop_config.json

{"mcpServers":{"repomix":{"command":"npx","args":["-y","repomix","--mcp"]}}}

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

.vscode/mcp.json

{
  "servers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "repomix",
        "--mcp"
      ]
    }
  }
}

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

Terminal

claude mcp add repomix -- npx -y repomix --mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中按文档配置 {"mcpServers":{"repomix":{"command":"npx","args":["-y","repomix","--mcp"]}}} 后重启客户端，工具列表应出现 pack_codebase、pack_remote_repository、grep_repomix_output 等工具；调用 pack_remote_repository "yamadashy/repomix" 若能返回打包摘要即证明连接成功。

常见排障

确认客户端使用 npx -y repomix --mcp，或检查 Docker 命令是否可用。
确认传入本地路径是绝对路径，并且目标目录或输出文件存在。
检查 .gitignore、.ignore、.repomixignore 和 include/ignore 模式是否排除了目标文件。
处理远程仓库时，检查仓库地址、分支或提交标识，并确认远程配置信任设置。

试试这样问

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

把本地这个项目打包成一个 XML 文件并给我一份摘要
用 pack_remote_repository 打包 https://github.com/facebook/react 并分析主要组件架构
在打包结果里 grep 所有包含 authentication 的代码并附上下文行
读取之前生成的 repomix 输出文件的第 1 到 200 行

工具能力 7

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 只读

列出本地目录内容。

使用场景

将代码库准备为 AI 代码审查、重构、文档生成和测试生成的上下文。

按模式筛选、压缩或搜索大型代码库。

直接分析远程 GitHub 仓库。

读取已有的打包输出并进行增量检索。

支持客户端

Claude Desktop

VS Code

Cline

Cursor

Claude Code

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

详细介绍

Repomix 是一个命令行工具和 MCP 服务器，可将本地或远程 GitHub 代码库打包为集中式输出，供 AI 助手进行代码分析。它支持 XML、Markdown、JSON 和纯文本格式，并提供压缩、令牌统计、文件筛选、Git 日志与差异等功能。