返回 MCP 目录
public公开dns本地运行

local-git-mcp-server

一个基于Python和MCP协议的本地Git仓库管理服务器

article

README

🚀 本地 Git MCP 服务器

这是一个基于 Python 的 Git 仓库管理服务器,借助消息通信协议 (Message-based Communication Protocol) 服务器框架搭建,可高效管理本地 Git 仓库。

🚀 快速开始

运行服务器,可使用以下命令:

python git_server.py [--repositories-dir ./ repositories]

✨ 主要特性

  • 创建、管理和与本地 Git 仓库进行交互。
  • 对仓库名称进行验证。
  • 执行各类 Git 操作,具体如下:
    • 仓库创建
    • 添加文件
    • 提交更改
    • 拉取和推送
    • 差异生成

📦 安装指南

本项目依赖以下库:

  • GitPython
  • Pydantic
  • MCP Server
  • Black(代码格式化)
  • isort(导入排序)

请确保在运行项目前安装好这些依赖项。

💻 使用示例

基础用法

# 运行服务器
python git_server.py [--repositories-dir ./ repositories]

🔧 技术细节

  • 代码会自动使用 Black 和 isort 进行格式化。
  • 利用 GitHub Actions 工作流实现代码格式化。

📄 许可证

[如适用,请添加许可信息]

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端