yl-mcp-server

v1.2.1

Published

2 months ago

MCP server for automated git operations

0High
0Medium
0Low

hyl999

mcp git model-context-protocol

YL MCP Servers

一个 MCP (Model Context Protocol) 服务器集合，为 AI 助手提供各种实用工具。通过与 Windsurf、Claude Desktop 等 AI 客户端集成，实现智能化的工作流自动化。

📦 包含的服务器

💻 yl-mcp-server

一个基于 MCP 的智能 Git 操作服务器，已发布到 npm，可直接通过 npx 使用。

✨ 主要功能：

🚀 智能提交: AI 自动分析代码变更并生成规范的 commit 信息
📊 状态查看: 快速查看 Git 仓库状态和变更内容
🔧 自动化操作: 一键完成 add、commit、push 流程
🎯 仓库初始化: 支持快速初始化 Git 仓库并配置远程地址

📦 安装方式：

# 通过 npx 直接使用（推荐）
npx -y yl-mcp-server

# 或全局安装
npm install -g yl-mcp-server

📄 查看详细文档 | 📦 npm 包页面

🚀 快速开始

方式一：通过 npx 使用（推荐）

无需安装，直接在 AI 客户端中配置：

{
  "mcpServers": {
    "yl-git-server": {
      "command": "npx",
      "args": ["-y", "yl-mcp-server"]
    }
  }
}

方式二：全局安装

npm install -g yl-mcp-server

然后配置：

{
  "mcpServers": {
    "yl-git-server": {
      "command": "yl-mcp-server"
    }
  }
}

方式三：本地开发

git clone <repository-url>
cd yl-git-server
npm install

配置：

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

📋 配置步骤（以 Windsurf 为例）

打开 Windsurf 设置 (⌘ + , 或 Ctrl + ,)
找到 "MCP Servers" 配置项
添加上述配置
重启 Windsurf
现在可以与 AI 助手对话使用 Git 功能了

✨ 开始使用

配置完成后，在 AI 客户端中即可使用：

帮我智能提交代码

AI 会自动分析你的代码改动，生成符合规范的 commit 信息并完成提交。

📝 使用示例

🚀 智能提交代码

"帮我智能提交代码"
"分析我的改动并自动提交"

📊 查看 Git 状态

"查看当前 Git 状态"
"显示我的代码改动"

🎯 初始化仓库

"初始化一个新的 Git 仓库，远程地址为 [email protected]:username/repo.git"

📂 添加文件

"添加所有文件到暂存区"
"只添加 src/ 目录下的文件"

🔄 完整工作流示例

用户："我修改了登录功能，帮我提交代码"
AI：  "我来帮你分析代码变更并智能提交..."
      [自动生成] feat(auth): 优化登录验证逻辑和错误处理
      [自动提交并推送]

🛠️ 开发

测试服务器

cd yl-git-server
npm test

启动服务器

npm start

📁 项目结构

yl-mcps/
├── yl-git-server/          # Git 操作 MCP 服务器
│   ├── src/
│   │   ├── index.js        # 服务器入口
│   │   ├── server.js       # MCP 服务器实现
│   │   ├── config.js       # 配置
│   │   ├── tool-definitions.js  # 工具定义
│   │   └── tool-handlers.js     # 工具处理器
│   ├── package.json
│   └── README.md
├── mcp_config.json         # MCP 配置文件
├── MCP_SETUP.md           # MCP 配置指南
└── README.md              # 本文件

🔧 技术栈

Node.js: 运行环境
@modelcontextprotocol/sdk: MCP SDK
ES Modules: 使用现代 JavaScript 模块系统

📋 系统要求

Node.js >= 16.0.0
Git >= 2.0.0
AI 客户端: Windsurf、Claude Desktop 等支持 MCP 的应用

🔧 故障排除

常见问题

【Mac环境】通过npx连接mcp失败

多数是因为权限问题导致。

执行以下命令修复权限：

sudo chown -R $(id -u):$(id -g) "$HOME/.npm"

这通常是由于之前使用 sudo npm 命令导致的缓存文件权限问题。

📊 版本信息

yl-mcp-server: v1.0.0
更新时间: 2025-11-12
npm 地址: https://www.npmjs.com/package/yl-mcp-server

🤝 贡献

欢迎提交 Issue 和 Pull Request！

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

🔗 相关链接

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

⭐ 如果这个项目对你有帮助，请给个 Star！