Gitopia MCP Server

Gitopia MCP服务器

MCP服务器 吉托皮亚 --分散的Git，具有链上治理、赏金和DAO管理。适用于Cursor、VS Code、克劳德代码、克劳德桌面、Windsurf和任何兼容MCP的工具。

57工具 | 3个提示 | 4个资源模板

零配置启动：首次使用时自动生成钱包。除了粘贴配置代码片段外，没有其他设置。

快速开始

Docker（推荐）

docker pull ghcr.io/gitopia/gitopia-mcp-server:latest

然后为编辑器添加配置（请参阅 编辑器设置 在......下面

原生二进制

下载自 ，或：

go install github.com/gitopia/gitopia-mcp-server/cmd/server@latest

需要Go 1.25+和 git-remote-gitopia的 (curl https://get.gitopia.com | bash).

编辑器设置

OpenAI Codex

codex mcp add gitopia -- docker run --rm -i --platform linux/amd64 \
  -v "${HOME}/.mcp/gitopia:/home/mcp/.mcp/gitopia" \
  -e MCP_WORKSPACE_PATH=/home/mcp/.mcp/gitopia/workspace \
  ghcr.io/gitopia/gitopia-mcp-server:latest stdio

或添加到 ~/.codex/config.toml:

[mcp_servers.gitopia]
command = "docker"
args = [
  "run", "--rm", "-i", "--platform", "linux/amd64",
  "-v", "${HOME}/.mcp/gitopia:/home/mcp/.mcp/gitopia",
  "-e", "MCP_WORKSPACE_PATH=/home/mcp/.mcp/gitopia/workspace",
  "ghcr.io/gitopia/gitopia-mcp-server:latest", "stdio"
]

完整的食品法典指南

Claude Code

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "gitopia": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--platform", "linux/amd64",
        "-v", "${HOME}/.mcp/gitopia:/home/mcp/.mcp/gitopia",
        "-v", "${PWD}:/workspace", "-w", "/workspace",
        "-e", "MCP_WORKSPACE_PATH=/workspace",
        "ghcr.io/gitopia/gitopia-mcp-server:latest", "stdio"
      ],
      "env": {}
    }
  }
}

完整的克劳德代码指南

Cursor

添加 ~/.cursor/mcp.json （macOS）或 %APPDATA%\Cursor\mcp.json （Windows）：

{
  "mcpServers": {
    "gitopia": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--platform", "linux/amd64",
        "-v", "${HOME}/.mcp/gitopia:/home/mcp/.mcp/gitopia",
        "-v", "${workspaceFolder}:/workspace", "-w", "/workspace",
        "-e", "MCP_WORKSPACE_PATH=/workspace",
        "ghcr.io/gitopia/gitopia-mcp-server:latest", "stdio"
      ],
      "env": {}
    }
  }
}

完整光标指南

VS Code

完整的VS代码指南

Windsurf

完整的风帆指南

Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "gitopia": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--platform", "linux/amd64",
        "-v", "${HOME}/.mcp/gitopia:/home/mcp/.mcp/gitopia",
        "-e", "MCP_WORKSPACE_PATH=/home/mcp/.mcp/gitopia/workspace",
        "ghcr.io/gitopia/gitopia-mcp-server:latest", "stdio"
      ],
      "env": {}
    }
  }
}

使用现有钱包？ 集 GITOPIA_MNEMONIC 在shell中，然后添加 "-e", "GITOPIA_MNEMONIC" 不要在配置文件中硬编码助记符。

工具（57）

上下文管理（4）

用户管理（1）

存储库管理（7）

标签，提交，发布（4）

问题管理（5）

拉取请求管理（6）

Git操作（5）

工作流编排（3）

标签管理（3）

DAO与治理（9）

赏金管理（6）

批处理和批准（4）

提示

安全

• 信任级别 闸门工具通道： readonly \< localwrite \< chainwrite
• 速率限制 链上写入操作（默认10/min，100/hr）
• 邮件列表 只有标志 /gitopia.gitopia.gitopia.* 和 /cosmos.group.v1.*
• 工作空间隔离 阻止路径遍历攻击
• 审批方式 在广播之前保存交易以进行明确确认
• 非root Docker 容器以无特权用户身份运行

看 安全.md 用于漏洞报告。

配置

看 env.example 查看完整列表。

工具集

控制哪些工具暴露给MCP客户端。有助于减少AI助手中上下文窗口的使用。

• TOOLSETS=all （默认）：所有57个工具
• TOOLSETS=core：52个工具（隐藏工作流编排器）
• TOOLSETS=core,workflow：与 all

对于Claude Code用户， TOOLSETS=core 建议使用，因为Claude可以原生编排git操作。

发展

go build ./cmd/server          # build
go test ./...                  # test
go vet ./...                   # lint
docker build -t gitopia-mcp-server:latest .  # docker

看 贡献.md 发展指南。

许可证

麻省理工学院