Git MCP Server

Name: Git MCP Server
Author: cyanheads

cyanheads

开始使用源码仓库官网与文档

Clone, commit, diff, branch, merge, rebase, stash, tag and manage worktrees in local git repositories.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add git --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env MCP_LOG_LEVEL='<MCP_LOG_LEVEL>' --env GIT_BASE_DIR='<GIT_BASE_DIR>' --env LOGS_DIR='<LOGS_DIR>' --env GIT_USERNAME='<GIT_USERNAME>' --env GIT_EMAIL='<GIT_EMAIL>' --env GIT_SIGN_COMMITS='<GIT_SIGN_COMMITS>' --env GIT_DEFAULT_PATH='<GIT_DEFAULT_PATH>' -- npx -y @cyanheads/git-mcp-server

~/.codex/config.toml

[mcp_servers.git]
command = "npx"
args = ["-y", "@cyanheads/git-mcp-server"]
env = { MCP_TRANSPORT_TYPE = "<MCP_TRANSPORT_TYPE>", MCP_LOG_LEVEL = "<MCP_LOG_LEVEL>", GIT_BASE_DIR = "<GIT_BASE_DIR>", LOGS_DIR = "<LOGS_DIR>", GIT_USERNAME = "<GIT_USERNAME>", GIT_EMAIL = "<GIT_EMAIL>", GIT_SIGN_COMMITS = "<GIT_SIGN_COMMITS>", GIT_DEFAULT_PATH = "<GIT_DEFAULT_PATH>" }

# codex mcp add git --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env MCP_LOG_LEVEL='<MCP_LOG_LEVEL>' --env GIT_BASE_DIR='<GIT_BASE_DIR>' --env LOGS_DIR='<LOGS_DIR>' --env GIT_USERNAME='<GIT_USERNAME>' --env GIT_EMAIL='<GIT_EMAIL>' --env GIT_SIGN_COMMITS='<GIT_SIGN_COMMITS>' --env GIT_DEFAULT_PATH='<GIT_DEFAULT_PATH>' -- npx -y @cyanheads/git-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "git": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

需要的环境变量

MCP_TRANSPORT_TYPE
MCP_LOG_LEVEL
GIT_BASE_DIR
LOGS_DIR
GIT_USERNAME
GIT_EMAIL
GIT_SIGN_COMMITS
GIT_DEFAULT_PATH

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐