Git仓库工具服务

一个提供本地Git仓库交互工具的服务,允许LLMs检查提交历史、差异和文件变更。

  • by rcx86
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rcx86/git-tools-mcp

使用说明

Git工具MCP服务器

一个模型上下文协议(MCP)服务器,提供与本地Git存储库交互的工具。此服务器允许LLM检查本地项目中的提交历史、差异和文件更改。

这是我内部用例的个人项目。

安装

您可以使用以下命令安装该软件包 uv 或 pip:

uv pip install .
# or
pip install .

用法

运行服务器

服务器可以在两种模式下运行:

  1. 标准模式 (默认):

    git-tools-mcp
    

    这是用于MCP客户端(如Claude Desktop或其他LLM接口)的标准模式。

  2. HTTP模式 上海证券交易所

    git-tools-mcp --http --port 8000
    

    这将使用服务器发送事件(SSE)通过HTTP运行服务器。

可用工具

服务器公开了以下工具:

  • git_get_commit_history(n: int = 10, cwd: Optional[str] = None)

    • 检索最后一个 n 提交哈希值。
    • n:要检索的提交数(默认值:10)。
    • cwd:工作目录(可选)。
  • git_get_commit_message(commit_hash: str, cwd: Optional[str] = None)

    • 获取特定提交哈希的提交消息。
    • commit_hash:提交的哈希值。
    • cwd:工作目录(可选)。
  • git_get_commit_diff(commit_hash: str, cwd: Optional[str] = None)

    • 获取特定提交的差异。
    • commit_hash:提交的哈希值。
    • cwd:工作目录(可选)。
  • git_get_changed_files(commit_hash: str, cwd: Optional[str] = None)

    • 列出在特定提交中更改的文件。
    • commit_hash:提交的哈希值。
    • cwd:工作目录(可选)。
  • git_is_git_repo(cwd: Optional[str] = None)

    • 检查目录是否为Git存储库。
    • cwd:要检查的目录(可选)。

发展

设置开发环境:

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate

# Install dependencies
uv pip install -e .