Git仓库浏览工具

一个基于Node.js和MCP协议的Git仓库浏览工具,提供仓库目录结构展示和文件内容读取功能。

  • by razorback16
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 razorback16/mcp-git-repo-browser

使用说明

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原生模块(加密、路径、操作系统)实现核心功能
  • 利用fs-extra增强文件操作
  • 使用简单的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许可证-请参阅 许可证 文件以获取详细信息。