MCP Git 仓库浏览器 (Node.js)

一个使用模型上下文协议 (MCP) 实现的 Git 仓库浏览器，基于 Node.js。

配置

将以下内容添加到您的 MCP 设置配置文件中：

{
    "mcpServers": {
        "mcp-git-repo-browser": {
            "command": "node",
            "args": ["/path/to/mcp-git-repo-browser/src/index.js"]
        }
    }
}

功能

该服务器提供两个主要工具：

1. git_directory_structure: 返回仓库目录结构的树状表示

   • 输入：仓库 URL
   • 输出：仓库结构的 ASCII 树状表示

2. 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

该服务器在 stdio 上运行，使其与 MCP 客户端兼容。

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。