MCP Git Repo 浏览器 (Node.js)

使用模型上下文协议 (MCP) 的 Git 存储库浏览器的 Node.js 实现。

安装

NPM（推荐）

npm install -g git-commands-mcp

手动安装

git clone https://github.com/bsreeram08/git-commands-mcp.git
cd git-commands-mcp
npm install

Related MCP server: MCP Git Repo Browser

配置

将其添加到您的 MCP 设置配置文件中：

{
  "mcpServers": {
    "git-commands-mcp": {
      "command": "git-commands-mcp"
    }
  }
}

对于手动安装，请使用：

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

特征

该服务器提供以下工具：

基本存储库操作

1. git_directory_structure ：返回存储库目录结构的树状表示

   • 输入：存储库 URL

   • 输出：存储库结构的 ASCII 树表示

2. git_read_files ：读取并返回存储库中指定文件的内容

   • 输入：存储库 URL 和文件路径列表

   • 输出：将文件路径映射到其内容的字典

3. git_search_code ：在存储库代码中搜索模式

   • 输入：存储库 URL、搜索模式、可选文件模式、区分大小写和上下文行

   • 输出：包含匹配行和上下文的搜索结果的 JSON

分支机构运营

4. git_branch_diff ：比较两个分支并显示它们之间更改的文件

   • 输入：存储库 URL、源分支、目标分支和可选的 show_patch 标志

   • 输出：包含提交计数和差异摘要的 JSON

提交操作

5. git_commit_history ：获取带有可选过滤的分支的提交历史记录

   • 输入：存储库 URL、分支名称、最大数量、作者过滤器、起始日期、终止日期和消息 grep

   • 输出：包含提交详细信息的 JSON

6. git_commits_details ：获取有关提交的详细信息，包括完整消息和差异

   • 输入：存储库 URL、分支名称、最大计数、include_diff 标志、作者过滤器、起始日期、终止日期和消息 grep

   • 输出：包含详细提交信息的 JSON

7. git_local_changes ：获取工作目录中未提交的更改

   • 输入：本地存储库路径

   • 输出：包含状态信息和差异的 JSON

项目结构

git-commands-mcp/
├── src/
│   ├── index.js         # Entry point
│   ├── server.js        # Main server implementation
│   ├── handlers/        # Tool handlers
│   │   └── index.js     # Tool implementation functions
│   └── utils/           # Utility functions
│       └── git.js       # Git-related helper functions
├── package.json
└── readme.md

实现细节

• 使用 Node.js 原生模块（crypto、path、os）实现核心功能

• 利用 fs-extra 增强文件操作

• 使用 simple-git 进行 Git 存储库操作

• 实现干净的错误处理和资源清理

• 根据存储库 URL 哈希创建确定性临时目录

• 尽可能重复使用克隆的存储库以提高效率

• 模块化代码结构，可维护性更好

要求

• Node.js 14.x 或更高版本

• 系统上安装的 Git

用法

如果通过 npm 全局安装：

git-commands-mcp

如果手动安装：

node src/index.js

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

持续集成/持续交付

该项目使用 GitHub Actions 进行持续集成和部署：

自动 NPM 发布

该存储库配置了 GitHub Actions 工作流，当更改推送到主分支时，会自动将包发布到 npm。

设置 NPM_AUTOMATION_TOKEN

要启用自动发布，您需要添加一个 npm Automation 令牌作为 GitHub 机密（即使启用了 2FA 的帐户也可以使用）：

1. 生成 npm Automation 令牌：

   • 在npmjs.com上登录你的 npm 帐户

   • 转到您的个人资料设置

   • 选择“访问令牌”

   • 点击“生成新令牌”

   • 选择“自动化”令牌类型

   • 设置适当的权限（需要对包进行“读写”）

   • 复制生成的token

2. 将令牌添加到您的 GitHub 存储库：

   • 前往你的 GitHub 仓库

   • 导航至“设置”>“机密和变量”>“操作”

   • 点击“新建存储库秘密”

   • 名称： NPM_AUTOMATION_TOKEN

   • 值：粘贴您的 npm Automation 令牌

   • 点击“添加秘密”

配置完成后，任何对主分支的推送都会触发工作流将包发布到 npm。

执照

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

链接

• GitHub 存储库

• NPM 包

• 报告问题