Commit Messages MCP 服务器

一个 MCP 服务器，可以帮助根据文件更改生成高质量的提交消息。

功能

• 约定检测: 基于示例提交消息自动检测使用的提交消息约定
• 变更分析: 分析文件更改以确定更改的类型和范围
• 破坏性变更检测: 识别代码中潜在的破坏性变更
• AI 驱动的消息生成: 使用 Google 的 Gemini AI 生成符合项目约定的提交消息

前提条件

• Node.js 18 或更高版本
• Google Gemini API 密钥

安装

# 克隆仓库
git clone https://github.com/yourusername/commit-messages.git
cd commit-messages

# 安装依赖
npm install

# 构建项目
npm run build

配置

将您的 Gemini API 密钥设置为环境变量：

export GEMINI_API_KEY=your_api_key_here

或者在项目根目录中创建一个 .env 文件：

GEMINI_API_KEY=your_api_key_here

与 Claude Desktop 一起使用

1. 将服务器添加到您的 Claude Desktop 配置文件：

{
    "mcpServers": {
        "commit-messages": {
            "command": "node",
            "args": ["/path/to/commit-messages/build/index.js"],
            "env": {
                "GEMINI_API_KEY": "your_api_key_here"
            }
        }
    }
}

2. 重启 Claude Desktop
3. 要求 Claude 使用提供的工具生成提交消息

示例提示：

• "为这些更改生成提交消息"
• "这些示例消息中使用的是什么提交约定？"
• "分析这些文件更改"
• "检查此 diff 中的破坏性更改"

可用工具

服务器提供以下工具：

detect-convention

基于示例提交消息检测使用的提交消息约定。

参数：

• commit_messages: 之前的提交消息示例

analyze-changes

分析文件中的更改。

参数：

• file_status: git status 或类似命令的输出，显示已更改的文件
• diff_content: git diff 或类似命令的输出，显示实际更改
• note (可选): 关于更改的附加上下文

detect-breaking-changes

检测文件中的破坏性更改。

参数：

• file_status: git status 或类似命令的输出，显示已更改的文件
• diff_content: git diff 或类似命令的输出，显示实际更改
• note (可选): 关于更改的附加上下文

generate-commit-message

根据更改生成提交消息。

参数：

• file_status: git status 或类似命令的输出，显示已更改的文件
• diff_content: git diff 或类似命令的输出，显示实际更改
• commit_messages: 之前的提交消息示例
• note (可选): 关于更改的附加上下文

开发

# 在开发模式下运行
npm run dev

# 构建项目
npm run build

# 启动服务器
npm start

许可证

MIT