Gitopia MCP Server 是 Gitopia 的 MCP 服务器。Gitopia 是一个去中心化 Git 平台，具备链上治理、赏金和 DAO 管理能力。该服务器可与 Cursor、VS Code、Claude Code、Claude Desktop、Windsurf 以及任何兼容 MCP 的工具配合使用。
主要能力 该服务器提供 57 个工具、3 个提示词和 4 个资源模板，覆盖以下功能分组：
- 上下文管理（4 个）
- 用户管理（1 个）
- 仓库管理（7 个）
- 标签、提交、发布（4 个）
- 议题管理（5 个）
- 拉取请求管理（6 个）
- Git 操作（5 个）
- 工作流编排（3 个）
- 标签管理（3 个）
- DAO 与治理（9 个）
- 赏金管理（6 个）
- 批量与审批（4 个）
使用方式 支持零配置启动：首次使用时自动生成钱包，除粘贴配置片段外无需其他设置。
Docker（推荐）：添加对应编辑器的配置（见下方编辑器设置）。
从 GitHub Releases 下载，或使用以下方式： 需要 Go 1.25+ 和 git-remote-gitopia（curl https://get.gitopia.com | bash）。
或添加到 ~/.codex/config.toml：完整 Codex 指南。
添加到项目的 .mcp.json：完整 Claude Code 指南。
添加到 ~/.cursor/mcp.json（macOS）或 %APPDATA%\Cursor\mcp.json（Windows）：完整 Cursor 指南。
完整 VS Code 指南。
完整 Windsurf 指南。
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：
使用已有钱包？在 shell 中设置 GITOPIA_MNEMONIC，然后在 Docker 参数中添加 "-e", "GITOPIA_MNEMONIC"。切勿在配置文件中硬编码助记词。
安全与限制
- 信任层级控制工具访问：readonly < localwrite < chainwrite
- 链写操作限流（默认 10/分钟，100/小时）
- 消息允许列表仅签名 /gitopia.gitopia.gitopia.* 和 /cosmos.group.v1.*
- 工作区隔离阻止路径遍历攻击
- 审批模式在广播前暂存交易以等待明确确认
- 非 root Docker 容器以非特权用户运行
- 漏洞报告见 SECURITY.md
- 完整环境变量列表见 env.example
工具集控制 可控制暴露给 MCP 客户端的工具，有助于减少 AI 助手的上下文窗口占用。
- TOOLSETS=all（默认）：全部 57 个工具
- TOOLSETS=core：52 个工具（隐藏工作流编排器）
- TOOLSETS=core,workflow：与 all 相同 对于 Claude Code 用户，推荐 TOOLSETS=core，因为 Claude 可以原生编排 Git 操作。
开发指南见 CONTRIBUTING.md。
