MCP Gitee
mcp-gitee is a Model Context Protocol (MCP) server implementation for Gitee. It provides a set of tools that interact with Gitee's API, allowing AI assistants to manage repository, issues, pull requests, etc.
What is MCP Gitee?
MCP Gitee is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp-gitee is a model context protocol (mcp) server implementation for gitee. it provides a set of tools that interact with gitee's api, allowing ai assistants to manage repository, issues, pull reques...
mcp-gitee is a Model Context Protocol (MCP) server implementation for Gitee. It provides a set of tools that interact with Gitee's API, allowing AI assistants to manage repository, issues, pull requests, etc.
This server falls under the Version Control category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- mcp-gitee is a Model Context Protocol (MCP) server implement
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-giteeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Gitee
mcp-gitee is a Go-based MCP server that exposes the full Gitee code hosting API to AI assistants, covering repositories, branches, pull requests, issues, comments, releases, and user search across 29 tools. It connects to Gitee using a personal access token and can run as a local stdio process or as a remote SSE/HTTP server. Development teams that host code on Gitee use it to let Claude manage issues, review pull requests, create releases, and search the open-source ecosystem through natural language.
Prerequisites
- A Gitee account with a personal access token (generated at gitee.com/profile/personal_access_tokens)
- Go 1.21 or later (if building from source) OR the pre-built mcp-gitee binary
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
- Network access to gitee.com (or your GITEE_API_BASE endpoint)
Obtain a Gitee personal access token
Log into gitee.com, go to Settings > Security > Personal Access Tokens, and generate a token with the repo, issues, and pull_requests scopes. Copy the token value—it will not be shown again.
Install the mcp-gitee binary
Install via go install for the quickest setup. Alternatively download a pre-built binary from the Gitee releases page or build from source with make build.
go install gitee.com/oschina/mcp-gitee@latestOpen your MCP client configuration file
For Claude Desktop edit claude_desktop_config.json. For Claude Code edit ~/.claude/settings.json or your project's .mcp.json.
Add the mcp-gitee server entry
Configure the server to run as a local stdio process using your personal access token. GITEE_API_BASE defaults to https://gitee.com/api/v5 and only needs to be set for private Gitee Enterprise instances.
{
"mcpServers": {
"gitee": {
"command": "mcp-gitee",
"args": ["--transport", "stdio"],
"env": {
"GITEE_ACCESS_TOKEN": "your-personal-access-token"
}
}
}
}Restart your MCP client
Reload Claude Desktop or Claude Code to start the mcp-gitee process. All 29 tools will appear in your AI assistant's toolset.
MCP Gitee Examples
Client configuration
claude_desktop_config.json entry using the locally installed mcp-gitee binary with stdio transport.
{
"mcpServers": {
"gitee": {
"command": "mcp-gitee",
"args": ["--transport", "stdio"],
"env": {
"GITEE_ACCESS_TOKEN": "your-personal-access-token",
"GITEE_API_BASE": "https://gitee.com/api/v5"
}
}
}
}Prompts to try
Example requests covering repositories, issues, pull requests, and search tools.
- "List all repositories in my Gitee account and their star counts"
- "Create a new issue in oschina/mcp-gitee titled 'Feature request: webhook support'"
- "Show me all open pull requests in my-org/my-repo that are awaiting review"
- "Merge the pull request #42 in my-org/my-repo"
- "Search Gitee for open-source Python web frameworks with more than 1000 stars"
- "Create a new release v1.2.0 for my-org/my-repo with the tag 'v1.2.0'"Troubleshooting MCP Gitee
401 Unauthorized or 'invalid access token' error
Check that GITEE_ACCESS_TOKEN is set correctly and that the token has not expired. Regenerate it at gitee.com/profile/personal_access_tokens and update your MCP config.
mcp-gitee command not found after go install
Ensure $GOPATH/bin (usually ~/go/bin) is in your PATH. Run 'export PATH=$PATH:$(go env GOPATH)/bin' and add it to your shell profile (.zshrc or .bashrc) for persistence.
Rate limit errors when running many operations
Gitee's API enforces per-token rate limits. Space out bulk operations or use ENABLED_TOOLSETS to expose only the tools you need, which reduces accidental over-use. Check your current limit at gitee.com/profile/personal_access_tokens.
Frequently Asked Questions about MCP Gitee
What is MCP Gitee?
MCP Gitee is a Model Context Protocol (MCP) server that mcp-gitee is a model context protocol (mcp) server implementation for gitee. it provides a set of tools that interact with gitee's api, allowing ai assistants to manage repository, issues, pull requests, etc. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Gitee?
Follow the installation instructions on the MCP Gitee GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Gitee?
MCP Gitee works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Gitee free to use?
Yes, MCP Gitee is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Gitee Alternatives — Similar Version Control Servers
Looking for alternatives to MCP Gitee? Here are other popular version control servers you can use with Claude, Cursor, and VS Code.
Ruiyu MA
★ 30.1kConnect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
GitMCP
★ 8.1kTransforms any GitHub repository or GitHub Pages site into a documentation hub for AI assistants using the Model Context Protocol. It allows AI tools to access real-time code and documentation to prevent hallucinations and provide accurate API usage
GitHub Codemunch
★ 1.8kA token-efficient MCP server for exploring GitHub repositories using tree-sitter AST parsing to extract symbol signatures and summaries. It enables users to search and retrieve specific code components while significantly reducing token consumption c
Azure DevOps MCP Server
★ 1.7kThis server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standard
GitHub Official
★ 1.2kOfficial GitHub integration with comprehensive API coverage
Azure DevOps
★ 367Enables interaction with Azure DevOps through Cursor chat, providing tools to manage builds, pipelines, work items, sprints, and board operations. Supports secure authentication via Personal Access Tokens and allows natural language-driven DevOps tas
Browse More Version Control MCP Servers
Explore all version control servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Gitee in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Gitee?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.