MCP服务器Git管理

Name: MCP服务器Git管理
Author: FradSer

作者：FradSer2 星标更新：2025-06-26

安装使用来源：spider==github.com

项目介绍

Git Commit Message Generator MCP Server

一个智能的MCP服务器，使用像DeepSeek和Groq这样的大语言模型提供商自动生成符合常规提交风格的提交信息。

特性

AI驱动: 利用大语言模型提供商（如DeepSeek、Groq）进行智能提交信息生成
常规提交: 遵循行业标准的提交信息规范
多提供商支持: 支持多个大语言模型提供商，并可轻松切换
MCP兼容: 无缝与Claude、Cursor、Gemini CLI和其他MCP客户端配合工作
简单设置: 通过环境变量进行简单配置

快速开始

克隆并安装：

git clone https://github.com/FradSer/mcp-server-git-cz.git
cd mcp-server-git-cz
uv venv && uv pip install -r requirements.txt

配置环境：

cp .env.example .env
# 编辑.env文件以添加您的API密钥

运行服务器：
```
uv run mcp-server-git-cz
```

安装

先决条件

Python 3.10+
uv 包管理器

分步安装

克隆仓库：

git clone https://github.com/FradSer/mcp-server-git-cz.git
cd mcp-server-git-cz

创建虚拟环境并安装依赖项：

uv venv
uv pip install -r requirements.txt

设置环境变量：

cp .env.example .env

编辑.env文件：

DEEPSEEK_API_KEY=your_deepseek_api_key
GROQ_API_KEY=your_groq_api_key
LLM_PROVIDER=deepseek  # 或者 groq

配置

环境变量

变量	描述	默认值	是否必需
`DEEPSEEK_API_KEY`	DeepSeek API密钥	-	是（如果使用DeepSeek）
`GROQ_API_KEY`	Groq API密钥	-	是（如果使用Groq）
`LLM_PROVIDER`	要使用的LLM提供商	`deepseek`	否

运输选项

服务器支持多种传输方式：

# STDIO传输（推荐）
uv run mcp-server-git-cz

# SSE传输
uv run mcp-server-git-cz --transport sse --port 8000

使用方法

服务器暴露了一个工具：generate_commit_message，该工具分析您的git差异并生成常规提交信息。

基本示例

import asyncio
from mcp.client.session import ClientSession
from mcp.client.stdio import StdioServerParameters, stdio_client

async def main():
    async with stdio_client(
        StdioServerParameters(command="uv", args=["run", "mcp-server-git-cz"])
    ) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # 生成提交信息
            result = await session.call_tool("generate_commit_message", {})
            print(result)

asyncio.run(main())

MCP客户端设置

注意：在以下所有配置中，请将/path/to/mcp-server-git-cz替换为您实际的项目目录路径。

Claude Code

# 项目范围（团队推荐）
claude mcp add git-cz -s project -- uv run --python /path/to/mcp-server-git-cz/.venv/bin/python -m mcp_server_git_cz

# 用户范围（个人使用）
claude mcp add git-cz -s user -- uv run --python /path/to/mcp-server-git-cz/.venv/bin/python -m mcp_server_git_cz

Cursor

添加到Cursor设置：

{
  "mcpServers": {
    "git-cz": {
      "command": "uv",
      "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"],
      "env": {},
      "transport": "stdio"
    }
  }
}

Gemini CLI

添加到~/.gemini/settings.json：

{
  "mcpServers": {
    "git-cz": {
      "command": "uv",
      "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"],
      "env": {}
    }
  }
}

<details> <summary>详细设置说明</summary>

查找您的路径

获取虚拟环境路径：

cd mcp-server-git-cz
uv venv
which python  # 复制此路径

获取项目目录：
```
pwd  # 复制此路径
```
更新配置 使用您实际的路径

高级配置

使用环境变量

{
  "mcpServers": {
    "git-cz": {
      "command": "uv",
      "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"],
      "env": {
        "DEEPSEEK_API_KEY": "your_key_here",
        "LLM_PROVIDER": "deepseek"
      }
    }
  }
}

使用工作目录

{
  "mcpServers": {
    "git-cz": {
      "command": "uv",
      "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"],
      "cwd": "/path/to/mcp-server-git-cz",
      "env": {}
    }
  }
}

</details>

示例

使用MCP客户端

一旦配置完成，您可以使用自然语言与工具交互：

"为我当前的更改生成提交信息"
"基于我的git差异创建常规提交信息"
"帮助我编写遵循常规提交规范的提交信息"

服务器将：

分析您的当前git差异
使用AI生成常规提交信息
返回格式化的消息供审查

示例输出

feat(auth): 添加GitHub的OAuth2集成

- 实现OAuth2认证流程
- 添加GitHub提供程序配置
- 更新用户模型以支持外部认证
- 为认证端点添加测试

关闭#123

贡献指南

我们欢迎贡献！请遵循以下指南：

开发设置

分叉仓库
创建功能分支：git checkout -b feature/amazing-feature
进行更改
运行测试：make test
使用常规提交格式提交：git commit -m 'feat: 添加惊人的功能'
推送到您的分支：git push origin feature/amazing-feature
打开Pull Request

代码风格

遵循PEP 8的Python代码规范
使用Black进行代码格式化
在适当的地方添加类型提示
为新功能编写测试

报告问题

发现bug？有功能请求？请打开一个issue，包括：

清晰的问题描述
复现步骤
预期行为与实际行为对比
环境细节

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

支持

文档: 完整文档
错误报告: GitHub Issues
功能请求: GitHub Discussions
邮件: fradser@gmail.com

致谢

常规提交规范
模型上下文协议框架
DeepSeek 和 Groq 提供AI能力
所有贡献者对改进此项目的帮助

<div align="center"> <strong>为开发者社区制作，充满爱心</strong> <br> <sub>⭐ 如果您觉得有用，请给这个仓库点赞！</sub> </div>