Skip to main content
Glama

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_7d and surge climb 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 sync

Add 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

Installation

All install methods (A-D), prerequisites

Onboarding

Free Gitee token, tier comparison, pitfalls

Wrapped platform

Gitee overview, API quirks, community links

Architecture

Dual transport, REST surface, caching, ecosystem layer, ports

Configuration

All env vars, local data stores

Tool Reference

Every tool and operation

Development

Dev setup, tests, contributing

Troubleshooting

Common issues and fixes

Feature Spec

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 translation

  • Optional: 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 /v1), default qwen2.5:7b

License

MIT

Available Tools

8 tools
gitee_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_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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers