1. 服务概述一句话简介智能git暂存MCP服务器让AI自动组织混乱的更改到干净、专注的提交中服务名称Git Polite版本号最新版本开发者/提供方uneco协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点自动驾驶模式让AI分析更改并自动创建多个专注的提交行级暂存按行号精确暂存单个添加和删除未跟踪文件支持暂存新创建文件的部分不仅是修改的文件范围选择使用范围一次应用多个更改如0001-0005,0020-0025LLM友好输出基于字节的分页和智能截断保护上下文窗口二进制文件检测自动检测并跳过二进制文件MCP集成与Claude Code、Claude Desktop和其他MCP客户端无缝协作3. 使用场景描述该服务适合在什么情况下使用AI驱动的提交组织让AI分析WIP并自动创建干净的提交历史增量提交将大型更改分解为逻辑、原子提交部分文件暂存仅暂存新文件的特定行其余保持未暂存代码审查准备将相关更改一起暂存即使分散在多个文件中重构以精确的方式分离格式更改和逻辑更改4. 接入方式4.1 服务端点Git Polite作为MCP服务器运行通过MCP协议与客户端通信直接操作本地Git仓库。4.2 认证与权限无需特殊认证使用本地Git配置。需要Git命令行工具。4.3 数据格式使用标准Git diff格式输出带有行号的JSON格式便于AI理解和操作。4.4 服务器配置方法一使用uvx推荐{ mcpServers: { git-polite: { command: uvx, args: [ git-politegithttps://github.com/uneco/mcp-git-polite.git, mcp ] } } }方法二使用Docker{ mcpServers: { git-polite: { command: docker, args: [ run, -i, --rm, -v, ${workspaceFolder}:/workspace, -w, /workspace, ghcr.io/uneco/mcp-git-polite:latest, mcp ] } } }5. 接口定义5.1 核心工具工具名称参数描述list_changespaths, page_token, page_size_files, page_size_bytes, unified列出未暂存的git更改包括未跟踪文件作为编号行diffpath, unified查看单个文件的完整diff不截断apply_changespath, numbers按编号将选定的更改应用到git索引auto_commit无启动自动驾驶模式将所有更改组织成专注的提交5.2 list_changes工具参数参数类型默认值描述paths可选-要过滤的文件路径列表page_token可选-分页令牌page_size_files可选50每页最大文件数page_size_bytes可选30KB每页最大累计字节数unified可选20更改周围的上下文行数6. 快速开始6.1 环境要求Python 3.10或更高版本Git命令行工具MCP服务器包mcp1.10.0MCP客户端Claude Code、Claude Desktop等6.2 示例代码步骤1配置MCP客户端# Claude CLI claude mcp add -s user git-polite uvx git-politegithttps://github.com/uneco/mcp-git-polite.git mcp步骤2使用示例# 在Claude Desktop中你可以 # - Auto-commit my messy changes into logical commits # - List all unstaged changes # - Stage lines 1-5 and 20-25 from src/main.py # 自动驾驶模式示例 # AI会分析所有更改并建议逻辑分组 # 然后引导你创建多个原子提交处理截断文件示例# 步骤1列出所有更改 result list_changes() # 步骤2注意到截断的文件 # { # path: src/api_client.py, # truncated: true, # reason: diff too large (45.2 KB, max 10 KB), # lines: [] # } # 步骤3查看完整的编号diff full_diff diff(pathsrc/api_client.py) # 步骤4选择性地暂存相关更改 apply_changes(pathsrc/api_client.py, numbers0001-0050,0120-0135)7. 注意事项文本文件仅适用于文本文件自动检测并跳过二进制文件行号临时性行号是临时的每次应用操作后都会更改上下文不匹配文件漂移会导致操作安全失败未跟踪文件对于未跟踪文件整个文件内容必须存在于工作目录中大文件截断大文件10KB diff在list_changes中会被截断使用diff工具查看智能截断大型diff10KB自动截断以保护LLM上下文许可证MIT许可证构建工具使用FastMCP和Model Context Protocol构建
1. 服务概述一句话简介智能git暂存MCP服务器让AI自动组织混乱的更改到干净、专注的提交中服务名称Git Polite版本号最新版本开发者/提供方uneco协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点自动驾驶模式让AI分析更改并自动创建多个专注的提交行级暂存按行号精确暂存单个添加和删除未跟踪文件支持暂存新创建文件的部分不仅是修改的文件范围选择使用范围一次应用多个更改如0001-0005,0020-0025LLM友好输出基于字节的分页和智能截断保护上下文窗口二进制文件检测自动检测并跳过二进制文件MCP集成与Claude Code、Claude Desktop和其他MCP客户端无缝协作3. 使用场景描述该服务适合在什么情况下使用AI驱动的提交组织让AI分析WIP并自动创建干净的提交历史增量提交将大型更改分解为逻辑、原子提交部分文件暂存仅暂存新文件的特定行其余保持未暂存代码审查准备将相关更改一起暂存即使分散在多个文件中重构以精确的方式分离格式更改和逻辑更改4. 接入方式4.1 服务端点Git Polite作为MCP服务器运行通过MCP协议与客户端通信直接操作本地Git仓库。4.2 认证与权限无需特殊认证使用本地Git配置。需要Git命令行工具。4.3 数据格式使用标准Git diff格式输出带有行号的JSON格式便于AI理解和操作。4.4 服务器配置方法一使用uvx推荐{ mcpServers: { git-polite: { command: uvx, args: [ git-politegithttps://github.com/uneco/mcp-git-polite.git, mcp ] } } }方法二使用Docker{ mcpServers: { git-polite: { command: docker, args: [ run, -i, --rm, -v, ${workspaceFolder}:/workspace, -w, /workspace, ghcr.io/uneco/mcp-git-polite:latest, mcp ] } } }5. 接口定义5.1 核心工具工具名称参数描述list_changespaths, page_token, page_size_files, page_size_bytes, unified列出未暂存的git更改包括未跟踪文件作为编号行diffpath, unified查看单个文件的完整diff不截断apply_changespath, numbers按编号将选定的更改应用到git索引auto_commit无启动自动驾驶模式将所有更改组织成专注的提交5.2 list_changes工具参数参数类型默认值描述paths可选-要过滤的文件路径列表page_token可选-分页令牌page_size_files可选50每页最大文件数page_size_bytes可选30KB每页最大累计字节数unified可选20更改周围的上下文行数6. 快速开始6.1 环境要求Python 3.10或更高版本Git命令行工具MCP服务器包mcp1.10.0MCP客户端Claude Code、Claude Desktop等6.2 示例代码步骤1配置MCP客户端# Claude CLI claude mcp add -s user git-polite uvx git-politegithttps://github.com/uneco/mcp-git-polite.git mcp步骤2使用示例# 在Claude Desktop中你可以 # - Auto-commit my messy changes into logical commits # - List all unstaged changes # - Stage lines 1-5 and 20-25 from src/main.py # 自动驾驶模式示例 # AI会分析所有更改并建议逻辑分组 # 然后引导你创建多个原子提交处理截断文件示例# 步骤1列出所有更改 result list_changes() # 步骤2注意到截断的文件 # { # path: src/api_client.py, # truncated: true, # reason: diff too large (45.2 KB, max 10 KB), # lines: [] # } # 步骤3查看完整的编号diff full_diff diff(pathsrc/api_client.py) # 步骤4选择性地暂存相关更改 apply_changes(pathsrc/api_client.py, numbers0001-0050,0120-0135)7. 注意事项文本文件仅适用于文本文件自动检测并跳过二进制文件行号临时性行号是临时的每次应用操作后都会更改上下文不匹配文件漂移会导致操作安全失败未跟踪文件对于未跟踪文件整个文件内容必须存在于工作目录中大文件截断大文件10KB diff在list_changes中会被截断使用diff工具查看智能截断大型diff10KB自动截断以保护LLM上下文许可证MIT许可证构建工具使用FastMCP和Model Context Protocol构建
