compare_branches_tags
Compare two branches, tags, or commits in a repository
Work a Gitee repository end to end — read an issue, open the pull request that closes it, review it and merge — without leaving your editor.
LABSCO SUMMARY
Reading an issue, opening the pull request against it, pulling the changed files, approving and merging with the related issue closed are all here, which is what makes this more than a read-only Gitee viewer. Two practical notes: the hosted endpoint means no install and no Go toolchain, and the allowlist and blocklist settings are worth using — a session that should only read repositories can be limited to exactly the tools that do so.
A Gitee server for repositories, issues, pull requests and notifications, available as a hosted endpoint or as a local binary. Which tools are exposed is configurable, by allowlist or blocklist.
A Gitee account and a personal access token. The quickest route needs no install at all: point the client at the official remote server at https://api.gitee.com/mcp with the token as an Authorization: Bearer header. Running it yourself means Go 1.23.0 or higher — go install gitee.com/oschina/mcp-gitee@latest, or make build from a clone — with the token in --token or GITEE_ACCESS_TOKEN. --api-base (or GITEE_API_BASE) points at a different Gitee instance, defaulting to https://gitee.com/api/v5, and --transport selects stdio, sse or http with --address setting the bind, default localhost:8000.
One command plus a key — go install gitee.com/oschina/mcp-gitee@latest, then supply credentials
USE CASES
Read the issue, open the pull request that implements it, and merge with the related issue closed and the source branch pruned.
Read the detail and the changed files, leave a comment on it, then approve it.
Search file contents at a specific ref with context lines around each hit, then read the file that turns out to matter.
Read the unread notifications, then open the issues and pull requests behind them.
Compare the branch against the last tag to see what is going out, then create the release against that commit.
Create the repository under a user, organization or enterprise, or fork an existing one to work from.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
compare_branches_tagsCompare two branches, tags, or commits in a repository
create_commentCreate a comment on an issue or pull request
create_issueCreate an issue
create_pullCreate a pull request
create_releaseCreate a release
create_repoCreate a repository (user, org, or enterprise)
fork_repositoryFork a repository
get_diff_filesGet a pull request diff files
get_file_contentGet the content of the specified file in the repository
get_pull_detailGet a pull request detail
get_repo_issue_detailGet the detail of an issue
get_user_infoThis is a tool from the gitee MCP server. Get information about the authenticated user
list_commentsList all comments for an issue or pull request
list_releasesList repository releases
list_repo_issuesList all issues in a repository
list_repo_pullsList repository pulls
list_user_notificationsList all notifications for authorized user
list_user_reposList user authorized repositories
manage_pull_reviewManage a pull request review (approve or cancel)
merge_pullMerge a pull request
search_files_by_contentSearch files by content in a repository
search_open_source_repositoriesSearch open source repositories on Gitee
search_usersSearch users on Gitee
update_issueUpdate an issue
update_pullUpdate a pull request
BEFORE YOU INSTALL
25 tools when we connected.
GITEE_ACCESS_TOKEN in your environment
CONTEXT COST
Rated by the size of the 25 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
go install gitee.com/oschina/mcp-gitee@latesthttps://api.gitee.com/mcpConnect a client to this instead of installing anything. Send your Gitee personal access token as an Authorization: Bearer header. Taken from this project's own documentation.
{
"mcpServers": {
"gitee": {
"type": "http",
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
}
}
}
}codex mcp add gitee --url https://api.gitee.com/mcp --bearer-token-env-var GITEE_ACCESS_TOKEN{
"mcpServers": {
"gitee": {
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
}
}
}
}{
"mcpServers": {
"gitee": {
"type": "streamableHttp",
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
},
"disabled": false,
"autoApprove": []
}
}
}{
"mcp": {
"gitee": {
"type": "remote",
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
},
"enabled": true
}
}
}