将 Gitea MCP 连接到 Cursor

💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → Gitea,粘贴你的凭据,生成一个 MCP API 密钥即可。无需 Docker,无需 git clone,无需本地服务器。

Gitea + Cursor

让你的 AI 读取你的 Gitea:查找仓库,分类处理 issue 和 pull request 及其评论、文件、diff 和评审,查看发布版本和组织,并读取分支、提交和文件。支持 gitea.com 或你自己的 Gitea 服务器,使用访问令牌。只读。

前提条件

请查看连接器内置的完整设置说明(在应用内商店选择该连接器即可看到)。此连接器所需的环境变量如下:

GITEA_URL, GITEA_TOKEN

第 1 步 — 获取凭据

设置大约需要 2 分钟。你需要一个 gitea.com 或你自己 Gitea 服务器上的账号,以及一个对 Repository、Issue、Organization 和 User 拥有 Read 权限的访问令牌。

1. 在 Gitea 中,点击你的头像,然后依次点击 Settings、Applications。在 Manage Access Tokens 下输入名称(例如 "AnythingMCP"),并将 Repository、Issue、Organization 和 User 设置为 Read(即权限范围 read:repository、read:issue、read:organization 和 read:user)。如果你的 Gitea 版本不支持令牌权限范围,该令牌将拥有其所属用户的全部权限。
2. 点击 Generate Token 并立即复制令牌:Gitea 只会显示一次。只把令牌本身粘贴到 GITEA_TOKEN,前面不要加 token 或 Bearer。连接器会自行添加 token。
3. 将 GITEA_URL 设置为你访问 Gitea 所用的地址,例如 https://gitea.com 或 https://git.example.com,不要带 /api/v1,也不要带末尾斜杠。如果 Gitea 部署在子路径下,请保留该子路径(https://example.com/gitea)。
4. 安装连接器并运行 gitea_get_current_user:它会显示令牌所属的用户,并确认地址和令牌均可用。

只读:全部 30 个工具都只读取数据。连接器无法在 Gitea 中创建、修改或删除任何内容,AI 看到的内容与令牌所属用户能看到的完全一致。

可读取的内容:仓库(在整个实例范围内搜索,或列出你的用户、某个组织或其他用户的仓库)、带评论、标签和里程碑的 issue、带变更文件、diff、提交和评审的 pull request、带说明和附件的发布版本、带成员和团队的组织、分支、提交、文件树以及文件内容。gitea_search_issues 可以在所有仓库中查找分配给你、由你创建或等待你评审的 issue 和 pull request。

仓库与编号:每个仓库都需要 owner(用户或组织)和 repo,即 https://host/owner/repo 中的两部分。同一仓库中的 issue 和 pull request 共用一个编号序列。Gitea 也把 pull request 视为 issue,因此 gitea_get_issue 和 gitea_list_issue_comments 同样可以用 pull request 编号来获取其标题、标签和讨论,而 gitea_get_pull_request、gitea_get_pull_request_files 和 gitea_get_pull_request_diff 则提供代码方面的信息。

你自己的服务器:位于内部主机(私有 IP 或内部名称)上的 Gitea,需要同一网络内自托管的 AnythingMCP,并将主机名加入 SSRF_ALLOWED_HOSTS,否则出站防护会拦截调用。Forgejo 以及基于它运行的 Codeberg 提供相同的 API v1 路由,因此 https://codeberg.org 这样的地址应该也能使用。该连接器是按照 Gitea API 编写的。

限制:Gitea 服务器默认每页返回 30 条,最多 50 条(由其 MAX_RESPONSE_ITEMS 设置决定),因此 AI 会请求下一页,而不是更大的 limit。超过 200 KB 的 pull request diff 和文件内容会被截断:其余内容请打开该 pull request 的 html_url 查看。

常见错误:401 表示令牌错误、已过期或已删除,或者 GITEA_URL 指向了另一台服务器。403 表示令牌缺少调用所需的权限范围(Gitea 会在消息中指明),例如查看 issue 需要 read:issue,查看组织需要 read:organization。404 表示仓库、issue 或文件不存在,或者该用户看不到它:对于被隐藏的私有资源,Gitea 会返回 404。422 会指出缺失或无效的字段。

该连接器不会创建或编辑 issue、评论、pull request、发布版本、分支或文件,不会合并或批准,也不涵盖 Actions 运行和工作流、软件包、wiki、通知、webhook、部署密钥或管理功能。

第 2 步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

第 3 步 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话 — 智能体现在可以调用 Gitea 的工具。

可用工具

常见问题

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

后续步骤

• 连接器落地页
• 连接到 Claude
• 连接到 ChatGPT