by oschina
Provides a set of tools to interact with Gitee's API, enabling AI assistants to manage repositories, issues, pull requests, notifications, and other Git operations.
Gitee MCP Server implements the Model Context Protocol for Gitee, exposing a programmable interface that AI assistants can call to perform common repository actions such as listing repos, creating issues, handling pull requests, and more.
go install
, or use the recommended npx
command:
{
"command": "npx",
"args": ["-y", "@gitee/mcp-gitee@latest"]
}
--token
, --api-base
). Example using environment variables:
export GITEE_API_BASE="https://gitee.com/api/v5"
export GITEE_ACCESS_TOKEN="<your token>"
mcp-gitee --address localhost:8000
mcp-gitee
) or let a client invoke it through the MCP host configuration defined in a JSON file.--enabled-toolsets
/ --disabled-toolsets
or corresponding environment variables.Q: Which Go version is required? A: Go 1.23.0 or newer.
Q: Can I run the server without installing anything locally?
A: Yes, use the npx
method which fetches the latest package and runs it directly.
Q: How do I limit the tools exposed to an AI assistant?
A: Use --enabled-toolsets
to whitelist or --disabled-toolsets
to blacklist specific tool names; the whitelist takes precedence if both are set.
Q: Where do I find the list of available tool names? A: The README includes a table of all tools with their categories and descriptions.
Q: Is the server open‑source? A: Yes, it is licensed under the MIT License and hosted at https://github.com/oschina/mcp-gitee.
Gitee MCP Server is a Model Context Protocol (MCP) server implementation for Gitee. It provides a set of tools for interacting with Gitee's API, allowing AI assistants to manage repositories, issues, pull requests, and more.
Clone the repository:
git clone https://gitee.com/oschina/mcp-gitee.git
cd mcp-gitee
Build the project:
make build
Move ./bin/mcp-gitee PATH env
go install gitee.com/oschina/mcp-gitee@latest
Check mcp-gitee version:
mcp-gitee --version
config example: Click to view more application configuration
{
"mcpServers": {
"gitee": {
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer <your personal access token>"
}
}
}
}
{
"mcpServers": {
"gitee": {
"command": "npx",
"args": [
"-y",
"@gitee/mcp-gitee@latest"
],
"env": {
"GITEE_API_BASE": "https://gitee.com/api/v5",
"GITEE_ACCESS_TOKEN": "<your personal access token>"
}
}
}
}
{
"mcpServers": {
"gitee": {
"command": "mcp-gitee",
"env": {
"GITEE_API_BASE": "https://gitee.com/api/v5",
"GITEE_ACCESS_TOKEN": "<your personal access token>"
}
}
}
}
--token
: Gitee access token--api-base
: Gitee API base URL (default: https://gitee.com/api/v5)--version
: Show version information--transport
: Transport type (stdio、sse or http, default: stdio)--address
: The host and port to start the server on (default: localhost:8000)--enabled-toolsets
: Comma-separated list of tools to enable (if specified, only these tools will be enabled)--disabled-toolsets
: Comma-separated list of tools to disableYou can also configure the server using environment variables:
GITEE_ACCESS_TOKEN
: Gitee access tokenGITEE_API_BASE
: Gitee API base URLENABLED_TOOLSETS
: Comma-separated list of tools to enableDISABLED_TOOLSETS
: Comma-separated list of tools to disableToolset management supports two modes:
Enable specified tools (whitelist mode):
--enabled-toolsets
parameter or ENABLED_TOOLSETS
environment variable--enabled-toolsets="list_user_repos,get_file_content"
Disable specified tools (blacklist mode):
--disabled-toolsets
parameter or DISABLED_TOOLSETS
environment variable--disabled-toolsets="list_user_repos,get_file_content"
Note:
enabled-toolsets
and disabled-toolsets
are specified, enabled-toolsets
takes precedenceThis project is licensed under the MIT License. See the LICENSE file for more details.
The server provides various tools for interacting with Gitee:
Tool | Category | Description |
---|---|---|
list_user_repos | Repository | List user authorized repositories |
get_file_content | Repository | Get the content of a file in a repository |
create_user_repo | Repository | Create a user repository |
create_org_repo | Repository | Create an organization repository |
create_enter_repo | Repository | Create an enterprise repository |
fork_repository | Repository | Fork a repository |
create_release | Repository | Create a release for a repository |
list_releases | Repository | List repository releases |
search_open_source_repositories | Repository | Search open source repositories on Gitee |
list_repo_pulls | Pull Request | List pull requests in a repository |
merge_pull | Pull Request | Merge a pull request |
create_pull | Pull Request | Create a pull request |
update_pull | Pull Request | Update a pull request |
get_pull_detail | Pull Request | Get details of a pull request |
comment_pull | Pull Request | Comment on a pull request |
list_pull_comments | Pull Request | List all comments for a pull request |
get_diff_files | Pull Request | Get a pull request diff files |
create_issue | Issue | Create an issue |
update_issue | Issue | Update an issue |
get_repo_issue_detail | Issue | Get details of a repository issue |
list_repo_issues | Issue | List repository issues |
comment_issue | Issue | Comment on an issue |
list_issue_comments | Issue | List comments on an issue |
get_user_info | User | Get current authenticated user information |
search_users | User | Search for users |
list_user_notifications | Notification | List user notifications |
We welcome contributions from the open-source community! If you'd like to contribute to this project, please follow these guidelines:
For more information, please refer to the CONTRIBUTING file.
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "gitee": { "command": "npx", "args": [ "-y", "@gitee/mcp-gitee@latest" ], "env": { "GITEE_API_BASE": "https://gitee.com/api/v5", "GITEE_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>" } } } }
Discover more MCP servers with similar functionality and use cases
by zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
by cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
by continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
by block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
by RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
by lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
by gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.