gitee-mcp
This server lets AI assistants discover, search, profile, translate, and monitor Chinese open-source projects on Gitee.
Explore activity radar: see what's humming on Gitee with ranked live activity, top-starred, top-forked, and language-filtered lists.
Get repo intel: fetch details, README, language breakdown, recent commits, file tree/contents, and branches for any public repo.
Search Gitee: find users anonymously, search repos (with a token), and list a user's public repos.
Translate Chinese to English: translate repo descriptions/issues/commits via local LLM, detect Chinese text, and check translation provider status.
Monitor webhooks: list and clear inbound push/star/fork/pull_request events.
Visualize in chat: render rich status and humming cards for at-a-glance insights.
Get help: access built-in tool, tier, and configuration guidance.
Works out of the box in anonymous mode, with a dark-theme webapp and optional Gitee token for full search.
Provides tools for interacting with Gitee (gitee.com), China's largest code hosting platform, including repo intel (details, README, language mix, commits, file tree, branches), search for users and repos, a live humming radar of activity, webhook event feeds, and translation of Chinese descriptions and issues to English via local LLM.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gitee-mcp What's trending on Gitee right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Works with any MCP host (Claude Desktop, Cursor, opencode) and ships a dark-theme webapp on ports 11161/11162. Anonymous mode works out of the box - no account, no credit card, real data. A free Gitee token unlocks repo search and top lists.
What this wraps
Gitee is the biggest Chinese-language code hosting platform (12M+ users, home of OpenHarmony, dromara/hutool, macrozheng/mall and much of China's OSS). Its ecosystem is nearly invisible from Western tooling, and its API is rate-limited and partially token-gated. gitee-mcp bridges it: anonymous mode works out of the box, a free token unlocks full search. See docs/WRAPPEE.md for the full picture.
Related MCP server: Gitee
Features
Humming radar - a live, ranked view of what is active on Gitee, computed from real commit/star/fork data. Gitee has no public trending API; the radar is our transparent methodology, not a simulation.
Momentum - every radar build persists history, so you can watch
momentum,momentum_7dandsurgeclimb as repos heat up, and read a weekly "who's rising" digest.Repo intel - details, README, language mix, recent commits, file tree, branches, a Chinese-OSS tech-stack fingerprint, release notes and observed star history for any public repo.
Search - users anonymously; repos with a free token. Queries are cross-lingual: "low-code" also finds 低代码.
Translation - Chinese descriptions, issues and commits to English via your local Ollama (honest dictionary-gloss fallback when no model runs).
Webhooks & watchlist - push/star/fork events, plus a persistent watchlist with change detection and auto-follow thresholds.
Ecosystem - org/fork-family graphs, GitHub mirror comparison, a README keyword corpus (BM25, RAG-lite) and an RSS feed of the radar.
Webapp - dark-theme dashboard for all of the above on 11161/11162.
Quick Install
Option A - drag and drop (Claude Desktop): download
gitee-mcp-v0.2.0.mcpb from
Releases and
drag it onto Claude Desktop. Works immediately in anonymous mode.
Option C - manual:
git clone https://github.com/sandraschi/gitee-mcp
cd gitee-mcp && uv syncAdd to claude_desktop_config.json:
{
"mcpServers": {
"gitee-mcp": {
"command": "uv",
"args": ["--directory", "C:\\path\\to\\gitee-mcp", "run", "python", "-m", "gitee_mcp.server"]
}
}
}All methods: INSTALL.md.
First time? Complete docs/ONBOARDING.md to create a free Gitee token (optional but unlocks repo search).
Example Prompts
"What is humming on Gitee right now?"
"Show me the 10 most active Python repos on Gitee, translated to English."
"Profile dromara/hutool and summarize its README."
"Search Gitee for users named macrozheng."
"Translate this to English: 企业级微服务快速开发框架"
Documentation
Doc | Contents |
All install methods (A-D), prerequisites | |
Free Gitee token, tier comparison, pitfalls | |
Gitee overview, API quirks, community links | |
Dual transport, REST surface, caching, ecosystem layer, ports | |
All env vars, local data stores | |
Every tool and operation | |
Dev setup, tests, contributing | |
Common issues and fixes | |
v0.2 ecosystem-intelligence spec (tiers, deferred) |
Requirements
Python 3.11+ (via
uv)Claude Desktop or any MCP host
Optional: Ollama (
winget install Ollama.Ollama,ollama pull qwen2.5:7b) for translationOptional: free Gitee token for repo search
Stack
Layer | Tech |
Backend | Python 3.11, FastMCP 3.4.4+ (MCP), FastAPI (REST), uvicorn, httpx, beautifulsoup4, Pydantic v2 |
Frontend | React 18, Vite 5, TypeScript, Tailwind CSS (dark), Zustand, Lucide, Framer Motion, react-router-dom, react-markdown |
Tooling | uv, just, ruff, pyright, pytest (+ pytest-cov, respx), Bun, Biome, Playwright |
Local LLM | Ollama (OpenAI-compatible |
License
MIT
Available Tools
8 toolsgitee_exploreA
Explore what is humming on Gitee - live ranked activity radar, top-starred and top-forked discovery.
[RATIONALE] Gitee has no public trending API (the explore pages are behind an anti-bot challenge). One tool consolidates the anonymous radar, the token-tier sorted searches, and seed maintenance instead of four separate discovery tools.
Return Format
{"success": bool, "message": str, "data": {"repos": [...], "total": int, "dead_seeds": [...], "tier": str, "generated_at": str}} Each repo: {full_name, owner, description, translation, language, stargazers_count, forks_count, pushed_at, activity_score, recent_commits}
Examples
gitee_explore(operation="humming", limit=10) gitee_explore(operation="humming", language="Python", translate=True) gitee_explore(operation="top_starred", limit=15)
Inputs: limit, language, operation, translate. Returns: object
gitee_helpB
Gitee MCP help - tools, tiers, configuration and tips.
Return Format
{"success": bool, "help": str}
Examples
gitee_help()
Inputs: no named parameters. Returns: object
gitee_repoA
Gitee repository intel - metadata, README, languages, commits, file tree and branches.
[RATIONALE] A single repo has many read surfaces; one portmanteau keeps the tool registry small while exposing all of them with a shared owner/repo contract.
Return Format
{"success": bool, "operation": str, "data": {...}} on success. On failure: {"success": false, "error": str, "error_type": str, "suggestions": [...]}
Examples
gitee_repo(operation="details", owner="dromara", repo="hutool") gitee_repo(operation="readme", owner="apache", repo="dubbo") gitee_repo(operation="commits", owner="macrozheng", repo="mall", limit=5) gitee_repo(operation="contents", owner="snailclimb", repo="JavaGuide", path="docs")
Inputs: repo (required), owner (required), operation (required), path, +1 more. Returns: object
gitee_searchA
Search Gitee users and repositories, or list a user's public repos.
[RATIONALE] Search is one domain with three surfaces (users, repos, user repos); one tool with an operation discriminator keeps discovery compact.
Return Format
{"success": bool, "operation": str, "data": [...], "count": int}
Examples
gitee_search(operation="users", query="sandra") gitee_search(operation="repos", query="fastmcp", limit=10) gitee_search(operation="user_repos", login="macrozheng", limit=20)
Inputs: query (required), operation (required), sort, limit, +1 more. Returns: object
gitee_translateA
Translate Chinese text to English - repo descriptions, issues, commit messages.
[RATIONALE] The core value of a Gitee bridge for non-Chinese speakers is reading the ecosystem; translation belongs next to discovery in the tool surface.
Return Format
{"success": bool, "operation": str, "translated": bool, "translation": str, "note": str | null}
Examples
gitee_translate(operation="zh_to_en", text="企业级微服务快速开发框架") gitee_translate(operation="detect", text="hello world") gitee_translate(operation="status")
Inputs: operation (required), text. Returns: object
gitee_webhookA
Inspect inbound Gitee webhook events (push, star, fork, pull_request...).
[RATIONALE] Gitee pushes events to POST /api/webhooks/gitee when a repo webhook is configured; this tool surfaces the captured feed so agents can react to CI pushes, stars and forks.
Return Format
{"success": bool, "operation": str, "events": [...], "count": int}
Examples
gitee_webhook(operation="list", limit=10) gitee_webhook(operation="clear")
Inputs: operation (required), limit. Returns: object
show_gitee_humming_cardB
Show what is humming on Gitee right now as a rich in-chat card.
[RATIONALE] Status/list tools MUST ship a Prefab surface per fleet SOTA - this card renders the radar ranking in chat without the agent reading raw JSON.
Return Format
ToolResult with content (plain text fallback) + structured PrefabApp card.
Examples
show_gitee_humming_card(limit=5)
Inputs: limit, translate.
show_gitee_status_cardA
Show gitee-mcp configuration status as a rich in-chat card.
[RATIONALE] Status tools MUST ship a Prefab surface - one call shows tier, token state, LLM provider health and rate-limit headroom at a glance.
Return Format
ToolResult with content (plain text fallback) + structured PrefabApp card.
Examples
show_gitee_status_card()
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Tools have distinct purposes overall: status, explore, help, repo intel, search, translation, webhooks. Minor overlap between gitee_explore and show_gitee_humming_card (both deal with trending data) but one is data retrieval and the other is a display card, so ambiguity is low.
Most tools use the 'gitee_' prefix followed by a verb (explore, repo, search, translate, webhook, help), but two tools use 'show_..._card' pattern, creating a mix. The inconsistency is noticeable though the pattern is still readable.
8 tools is a reasonable number for a domain-specific MCP server focused on exploring Gitee. It covers key areas without being overwhelming or insufficient. Slightly on the lower side, but appropriate for the read-only scope.
The tool set covers discovery (explore, search, repo details), translation, webhook inspection, and status/help. It is read-only, which is clearly intentional. Missing operations like issue/PR listing or creating are not crucial given the stated purpose of non-Chinese speaker exploration.
Maintenance
Related MCP Connectors
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Search 386+ AI tools with China-access data, live GitHub stats, 4-language metadata. No key needed
An MCP server that gives your AI access to the source code and docs of all public github repos
Dive into the world of open-source with the GitHub Repo Explorer! Utilize the powerful GitHub
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP Tool Server for Gitee, supporting the management of repository files/branches, Issues, and Pull Requests.2082 npm7MIT
- AlicenseNot gradedqualityCmaintenanceGitee API integration, repository, issue, and pull request management, and more.65MIT
- AlicenseBqualityDmaintenanceFull-featured MCP server exposing 200+ Gitee API v5 endpoints for repository, issue, pull request, user, enterprise, gist, and search management.10019 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered GitHub interactions including repository analysis, code search, PR reviews, and more through the MCP protocol.4MIT