MCP Git Repo Browser (Node.js)

MCP Git Repo Browser (Node.js)

site icon
2025.03.21 0
JavaScriptGit 仓库浏览器代码管理工具开发效率
git-commands-mcp 是一个基于 Node.js 实现的 Git 仓库浏览器,使用 Model Context Protocol (MCP) 协议。它提供了一系列工具来浏览和操作 Git 仓库,包括查看目录结构、读取文件内容、搜索代码、比较分支差异、获取提交历史等。适用于开发者在本地或远程 Git 仓库中进行代码浏览和管理的场景。
View on GitHub

Overview

基本能力

产品定位

git-commands-mcp 是一个基于 Node.js 的 Git 仓库浏览器,通过 MCP 协议提供对 Git 仓库的浏览和操作功能。

核心功能

  1. 基本仓库操作
  2. git_directory_structure: 返回仓库目录结构的树状表示
  3. git_read_files: 读取并返回指定文件的内容
  4. git_search_code: 在仓库代码中搜索指定模式

  5. 分支操作

  6. git_branch_diff: 比较两个分支并显示文件差异

  7. 提交操作

  8. git_commit_history: 获取分支的提交历史
  9. git_commits_details: 获取提交的详细信息
  10. git_local_changes: 获取工作目录中的未提交更改

适用场景

  • 开发者需要快速浏览 Git 仓库的目录结构和文件内容
  • 团队需要比较分支差异或查看提交历史
  • 开发者需要在代码库中搜索特定模式

工具列表

  1. git_directory_structure: 返回仓库目录结构的 ASCII 树状表示
  2. git_read_files: 读取并返回指定文件的内容
  3. git_search_code: 在仓库代码中搜索指定模式
  4. git_branch_diff: 比较两个分支并显示文件差异
  5. git_commit_history: 获取分支的提交历史
  6. git_commits_details: 获取提交的详细信息
  7. git_local_changes: 获取工作目录中的未提交更改

常见问题解答

  • 如何安装? 可以通过 npm 全局安装或手动克隆仓库安装。
  • 如何配置? 需要在 MCP 配置文件中添加相应的配置项。
  • 运行方式? 可以通过命令行直接运行或通过 node 启动。

使用教程

使用依赖

  • Node.js 14.x 或更高版本
  • Git 已安装在系统中

安装教程

NPM 安装(推荐)

npm install -g git-commands-mcp

手动安装

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

调试方式

全局安装后运行

git-commands-mcp

手动安装后运行

node src/index.js

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。