@gitee/mcp-gitee

中文文档
1.0.0发布于 2026/04/23MITCommonJS零依赖近 30 天下载 2411

Model Context Protocol (MCP) server for Gitee

原始使用文档
文档目录13 节
  1. Features
  2. Installation(This step can be skipped directly when startin…
  3. Prerequisites
  4. Building from Source
  5. Use go install
  6. Usage
  7. MCP Hosts Configuration
  8. Command-line Options
  9. Environment Variables
  10. Toolset Management
  11. License
  12. Available Tools
  13. Contribution

Gitee MCP Server

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.

Install MCP Server

Features

  • Interact with Gitee repositories, issues, pull requests, and notifications
  • Configurable API base URL to support different Gitee instances
  • Command-line flags for easy configuration
  • Supports both personal, organization, and enterprise operations
  • Dynamic toolset enable/disable
Practical scenario: Obtain Issue from the repository, implement and create a Pull Request
  1. Get repository Issues get_repo_issues
  2. Implement coding & create Pull Request based on Issue details implement_issue
  3. Comment & Close Issue comment_and_close_issue

Installation(This step can be skipped directly when starting npx)

Prerequisites

  • Go 1.23.0 or higher
  • Gitee account with an access token, Go to get

Building from Source

  1. Clone the repository:

    git clone https://gitee.com/oschina/mcp-gitee.git
    cd mcp-gitee
    
  2. Build the project:

    make build
    

    Move ./bin/mcp-gitee PATH env

Use go install

go install gitee.com/oschina/mcp-gitee@latest

Usage

Check mcp-gitee version:

mcp-gitee --version

MCP Hosts Configuration

config example: Click to view more application configuration

  • Connect to the official remote mcp-gitee server (no installation required)
{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}
  • npx
{
  "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>"
      }
    }
  }
}
  • executable
{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

Command-line Options

  • --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 disable

Environment Variables

You can also configure the server using environment variables:

  • GITEE_ACCESS_TOKEN: Gitee access token
  • GITEE_API_BASE: Gitee API base URL
  • ENABLED_TOOLSETS: Comma-separated list of tools to enable
  • DISABLED_TOOLSETS: Comma-separated list of tools to disable

Toolset Management

Toolset management supports two modes:

  1. Enable specified tools (whitelist mode):

    • Use --enabled-toolsets parameter or ENABLED_TOOLSETS environment variable
    • Specify after, only listed tools will be enabled, others will be disabled
    • Example: --enabled-toolsets="list_user_repos,get_file_content"
  2. Disable specified tools (blacklist mode):

    • Use --disabled-toolsets parameter or DISABLED_TOOLSETS environment variable
    • Specify after, listed tools will be disabled, others will be enabled
    • Example: --disabled-toolsets="list_user_repos,get_file_content"

Note:

  • If both enabled-toolsets and disabled-toolsets are specified, enabled-toolsets takes precedence
  • Tool names are case-sensitive

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Available Tools

The server provides various tools for interacting with Gitee:

ToolCategoryDescription
list_user_reposRepositoryList user authorized repositories
get_file_contentRepositoryGet the content of a file in a repository
create_repoRepositoryCreate a repository (user, org, or enterprise)
fork_repositoryRepositoryFork a repository
create_releaseRepositoryCreate a release for a repository
list_releasesRepositoryList repository releases
search_open_source_repositoriesRepositorySearch open source repositories on Gitee
search_files_by_contentRepositorySearch files by content in a repository
compare_branches_tagsRepositoryCompare two branches, tags, or commits in a repository
list_repo_pullsPull RequestList pull requests in a repository
merge_pullPull RequestMerge a pull request
create_pullPull RequestCreate a pull request
update_pullPull RequestUpdate a pull request
get_pull_detailPull RequestGet details of a pull request
get_diff_filesPull RequestGet a pull request diff files
manage_pull_reviewPull RequestManage a pull request review (approve or cancel)
create_commentCommentCreate a comment on an issue or pull request
list_commentsCommentList all comments for an issue or pull request
create_issueIssueCreate an issue
update_issueIssueUpdate an issue
get_repo_issue_detailIssueGet details of a repository issue
list_repo_issuesIssueList repository issues
get_user_infoUserGet current authenticated user information
search_usersUserSearch for users
list_user_notificationsNotificationList user notifications

Contribution

We welcome contributions from the open-source community! If you'd like to contribute to this project, please follow these guidelines:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and ensure the code is well-documented.
  4. Submit a pull request with a clear description of your changes.

For more information, please refer to the CONTRIBUTING file.

版本与发布记录

@gitee/mcp-gitee 共发布 10 个版本,首次发布于 2025/04/24;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.0.0latest2026/04/236 个月前
0.1.172026/04/236 个月前
0.1.162026/03/247 个月前
0.1.152026/03/048 个月前
0.1.142025/11/131 年前
0.1.132025/07/241.3 年前

关于 @gitee/mcp-gitee 的常见问题

@gitee/mcp-gitee 是什么?

Model Context Protocol (MCP) server for Gitee

如何安装 @gitee/mcp-gitee?

在项目目录运行 npm install @gitee/mcp-gitee,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-gitee,可以用 npx mcp-gitee 直接运行。

@gitee/mcp-gitee 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gitee__mcp-gitee 是否存在。

@gitee/mcp-gitee 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@gitee/mcp-gitee 可以商用吗?

@gitee/mcp-gitee 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gitee/mcp-gitee 的下载量有多少?

根据 npm 官方下载统计,@gitee/mcp-gitee 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,411 次,日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gitee/mcp-gitee 还在维护吗?

最新版本 1.0.0 发布于 2026/04/23(6 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 4 个;首次发布于 2025/04/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。