Overview
What is Gitee MCP Server?
Gitee MCP Server lets AI operate Gitee repositories, Issues, and Pull Requests through the Model Context Protocol (MCP). It is designed for developers who want to integrate AI assistants with Gitee’s development workflows.
How to use Gitee MCP Server?
Install via Smithery, npx, or Docker. Configure the GITEE_PERSONAL_ACCESS_TOKEN environment variable (required) and optionally GITEE_API_BASE_URL and DEBUG. The server runs over stdio and can be invoked by MCP clients like Claude Desktop. Example configuration for claude_desktop_config.json uses npx -y gitee-mcp-server with the token set in the env field.
Key features of Gitee MCP Server
- Create, fork, and manage Gitee repositories
- Create and list branches in a repository
- Read, create, update, and push files
- Create, list, get, update, and comment on issues
- Create, list, get, update, and merge pull requests
- Retrieve Gitee user information
Use cases of Gitee MCP Server
- Automatically create and manage Gitee issues from AI conversations
- Let AI assistants push code changes and create pull requests
- Retrieve repository and branch details for automated workflows
- Merge pull requests without leaving the chat interface
FAQ from Gitee MCP Server
What operations does Gitee MCP Server support?
It supports repository, branch, file, issue, pull request, and user operations via named MCP tools like create_repository, create_branch, get_file_contents, create_issue, create_pull_request, and get_user.
How do I get a Gitee personal access token?
Generate a personal access token from your Gitee account settings at Personal Access Tokens. This token is required for authentication.
Can I run Gitee MCP Server in Docker?
Yes. Pull the image normalcoder/gitee-mcp-server from DockerHub (or build locally) and run it with the GITEE_PERSONAL_ACCESS_TOKEN environment variable set. Example MCP client configuration uses docker run -i --rm -e GITEE_PERSONAL_ACCESS_TOKEN.
What are the runtime dependencies?
Node.js version 22.12.0 or higher is required. The server packages include @modelcontextprotocol/sdk, universal-user-agent, zod, and zod-to-json-schema.
Where does the server run and how does it communicate?
The MCP server runs on stdio, acting as a subprocess for MCP clients. It can be debugged using @modelcontextprotocol/inspector with a .env file.
