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 Gitee?
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
- create_repository
- fork_repository
- create_branch
- list_branches
- get_branch
Use Cases
Maintainer
Works with
Installation
NPM
npx -y gitee-mcp-serverManual Installation
npx -y gitee-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Gitee
The Gitee MCP server is an official Go-based implementation of the Model Context Protocol for the Gitee code hosting platform, exposing 29 API tools that cover repositories, branches, pull requests, issues, comments, releases, file content retrieval, and user and organisation search. It authenticates via a Gitee personal access token and supports stdio, SSE, and HTTP transports so it works with Claude Desktop, Claude Code, Cursor, and remote agent deployments. Engineering teams that use Gitee for source control use it to create issues, review and merge pull requests, search the open-source ecosystem, and automate repository operations through conversational AI.
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 use the hosted endpoint at https://api.gitee.com/mcp
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
- Network access to gitee.com or your private Gitee Enterprise API base URL
Generate a Gitee personal access token
Sign in to gitee.com, go to Settings > Security > Personal Access Tokens, create a new token with repo, issues, and pull_requests scopes, and copy the token value.
Option A: Use the hosted Gitee MCP endpoint
Gitee operates a publicly hosted MCP server at https://api.gitee.com/mcp. No local binary is needed. Configure your client to point at this URL with your token in the Authorization header.
{
"mcpServers": {
"gitee": {
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer your-personal-access-token"
}
}
}
}Option B: Install and run the binary locally
For local stdio transport, install the mcp-gitee binary via go install and configure your MCP client to launch it as a subprocess.
go install gitee.com/oschina/mcp-gitee@latestAdd the local binary server entry
Use this config when running the binary locally. GITEE_ACCESS_TOKEN is picked up from the environment, or pass it with the --token flag.
{
"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. All 29 Gitee tools will appear in your AI assistant's available toolset.
Gitee Examples
Client configuration (hosted endpoint)
The simplest setup: use Gitee's hosted MCP endpoint with your personal access token. No binary installation required.
{
"mcpServers": {
"gitee": {
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer your-personal-access-token"
}
}
}
}Prompts to try
Example requests that exercise repository, issue, pull request, search, and release tools.
- "List all repositories in my Gitee account with their visibility and star counts"
- "Create an issue in my-org/my-repo titled 'Bug: login fails on Safari' with label bug"
- "Show me all open pull requests in my-org/my-repo and summarise the changes"
- "Merge pull request #15 in my-org/my-repo"
- "Search Gitee open-source repositories for Go HTTP routers with more than 500 stars"
- "Create a release tagged v2.0.0 for my-org/my-repo with a changelog summary"
- "Get the contents of the file src/main.go in my-org/my-repo on the main branch"Troubleshooting Gitee
401 Unauthorized when connecting to the hosted endpoint
Verify your personal access token is correct and has not expired. Check at gitee.com/profile/personal_access_tokens. Ensure the Authorization header value is exactly 'Bearer <token>' with no extra spaces.
mcp-gitee binary not found after go install
Add $GOPATH/bin to your PATH. Run 'export PATH=$PATH:$(go env GOPATH)/bin' and add this line to your ~/.zshrc or ~/.bashrc. Verify with 'which mcp-gitee' and 'mcp-gitee --version'.
Only some tools are available; others are missing
Use the ENABLED_TOOLSETS environment variable to whitelist specific tool categories, or DISABLED_TOOLSETS to blacklist them. When using the hosted endpoint, pass X-MCP-Enabled-Tools or X-MCP-Disabled-Tools HTTP headers per-request to control tool visibility.
Frequently Asked Questions about Gitee
What is Gitee?
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 Gitee?
Install via npm with the command: npx -y gitee-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Gitee?
Gitee works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Gitee free to use?
Yes, Gitee is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Gitee Alternatives — Similar Version Control Servers
Looking for alternatives to 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 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 Gitee?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.