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)

Gitee MCP help - tools, tiers, configuration and tips.

Return Format

{"success": bool, "help": str}

Examples

gitee_help()

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)

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()

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")

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)

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")

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")