Git 仓库浏览器
一个允许通过MCP浏览Git仓库的Node.js服务器,提供查看目录结构和读取仓库中重要文件的工具。
可用工具 (2 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
git_directory_structure 1 个参数 需填 1 项
Clone a Git repository and return its directory structure in a tree format.
必填参数:repo_url
git_read_important_files 2 个参数 需填 2 项
Read the contents of specified files in a given git repository.
必填参数:repo_url、file_paths
服务介绍
MCP Git Repo Browser (Node.js)
一个使用模型上下文协议(MCP)实现的Git仓库浏览器的Node.js版本。
配置
将以下内容添加到您的MCP设置配置文件中:
{
"mcpServers": {
"mcp-git-repo-browser": {
"command": "node",
"args": ["/path/to/mcp-git-repo-browser/src/index.js"]
}
}
}
特性
该服务器提供了两个主要工具:
-
git_directory_structure: 返回仓库目录结构的树状表示- 输入: 仓库URL
- 输出: 仓库结构的ASCII树形表示
-
git_read_important_files: 读取并返回仓库中指定文件的内容- 输入: 仓库URL和文件路径列表
- 输出: 文件路径与它们内容之间的映射字典
实现细节
- 使用Node.js原生模块(crypto, path, os)来实现核心功能
- 利用fs-extra进行增强的文件操作
- 使用simple-git来进行Git仓库操作
- 实现了清晰的错误处理和资源清理
- 根据仓库URL哈希创建确定性的临时目录
- 在可能的情况下重用已克隆的仓库以提高效率
要求
- Node.js 14.x 或更高版本
- 系统上安装有Git
安装
git clone <repository-url>
cd mcp-git-repo-browser
npm install
使用
启动服务器:
node src/index.js
服务器运行于标准输入输出,使其能与MCP客户端兼容。
许可证
MIT许可证 - 详情请参阅LICENSE文件。