gitee-mcp

连接 Gitee（gitee.com）——中国最大的 GitHub 风格平台：了解中文开源社区的动态，获取仓库信息，搜索用户和仓库，并使用本地 LLM 将中文描述翻译为英文。

本工具封装了什么

Gitee 是最大的中文代码托管平台（拥有 1200 万+ 用户，承载 OpenHarmony、dromara/hutool、macrozheng/mall 等众多中国开源项目）。其生态系统在西方工具链中几乎不可见，API 存在速率限制且部分需要令牌。gitee-mcp 提供了桥梁：匿名模式开箱即用，免费令牌即可解锁完整搜索。详见 docs/WRAPPEE.md。

Related MCP server: Gitee

你能做什么

• 热度雷达 —— 基于真实的提交/星标/派生数据（Gitee 没有公开的热门 API；我们的雷达采用透明的方法论，并非模拟），实时展示 Gitee 上的活跃项目排名。

• 仓库信息 —— 获取任意公开仓库的详细信息、README、语言构成、近期提交、文件树和分支。

• 搜索 —— 匿名搜索用户；使用免费令牌搜索仓库。

• 翻译 —— 通过 Ollama 将中文描述、议题和提交翻译为英文（若本地模型未运行，则回退为词典注释）。

• Webhooks —— 接收推送/星标/派生事件，并查看动态。

• Webapp —— 深色主题仪表盘，集成上述所有功能（端口 11161/11162）。

预览

快速安装

选项 A - 拖放安装（Claude Desktop）： 从 Releases 下载 gitee-mcp-v0.1.0.mcpb，然后拖放到 Claude Desktop 上。匿名模式即刻可用。

选项 C - 手动安装：

git clone https://github.com/sandraschi/gitee-mcp
cd gitee-mcp && uv sync

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "gitee-mcp": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\gitee-mcp", "run", "python", "-m", "gitee_mcp.server"]
    }
  }
}

所有安装方法详见：INSTALL.md。

首次使用？ 完成 docs/ONBOARDING.md 以创建免费的 Gitee 令牌（可选，但可解锁仓库搜索）。

示例提示

• “Gitee 上现在有什么热门项目？”

• “展示 Gitee 上最活跃的 10 个 Python 仓库，并翻译为英文。”

• “查看 dromara/hutool 的概况，并总结其 README。”

• “在 Gitee 上搜索名为 macrozheng 的用户。”

• “将这句翻译为英文：企业级微服务快速开发框架”

文档

环境要求

• Python 3.11+（通过 uv）

• Claude Desktop 或任何 MCP 主机

• 可选：Ollama（winget install Ollama.Ollama，ollama pull qwen2.5:7b）用于翻译

• 可选：用于仓库搜索的免费 Gitee 令牌

许可证

MIT