MCP Gitee

Gitee MCP服务器

Gitee MCP Server是Gitee的模型上下文协议（MCP）服务器实现。它提供了一套与Gitee的API交互的工具，允许AI助手管理存储库、问题、拉取请求等。


特性

• 与Gitee仓库、问题、拉取请求和通知交互
• 可配置的API基础URL支持不同的Gitee实例
• 命令行标志便于配置
• 支持个人、组织和企业运营
• 动态工具集启用/禁用

Practical scenario: Obtain Issue from the repository, implement and create a Pull Request

1. 获取存储库问题

get_repo_issues

1. 根据问题详细信息实施编码并创建Pull Request

implement_issue

1. 评论并关闭问题

comment_and_close_issue

安装（启动npx时可以直接跳过此步骤）

先决条件

• 达到1.23.0或更高
• 具有访问令牌的Gitee帐户， 去拿

从源代码构建

1. 克隆存储库：

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee

1. 构建项目：

   make build

移动。/bin/mcp gitee路径环境

使用go安装

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

用法

检查mcp-gitee版本：

mcp-gitee --version

MCP主机配置

配置示例： 单击查看更多应用程序配置

• 连接到官方远程mcp-gitee服务器（无需安装）

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

• 新巴拿马型船舶

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": ""
      }
    }
  }
}

• 可执行

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": ""
      }
    }
  }
}

命令行选项

• --token：Gitee访问令牌
• --api-base：Gitee API基础URL（默认值：https://gitee.com/api/v5)
• --version：显示版本信息
• --transport：传输类型（stdio、sse或http，默认：stdio）
• --address：启动服务器的主机和端口（默认值：localhost:8000）
• --enabled-toolsets：以逗号分隔的要启用的工具列表（如果指定，则仅启用这些工具）
• --disabled-toolsets：以逗号分隔的禁用工具列表

环境变量

您还可以使用环境变量配置服务器：

• GITEE_ACCESS_TOKEN：Gitee访问令牌
• GITEE_API_BASE：Gitee API基础URL
• ENABLED_TOOLSETS：要启用的工具列表，以逗号分隔
• DISABLED_TOOLSETS：以逗号分隔的禁用工具列表

工具集管理

工具集管理支持两种模式：

1. 启用指定工具（白名单模式）：

- 使用 --enabled-toolsets 参数或 ENABLED_TOOLSETS 环境变量 - 指定后，将仅启用列出的工具，禁用其他工具 - 例子： --enabled-toolsets="list_user_repos,get_file_content"

1. 禁用指定工具（黑名单模式）：

- 使用 --disabled-toolsets 参数或 DISABLED_TOOLSETS 环境变量 - 指定后，列出的工具将被禁用，其他工具将被启用 - 例子： --disabled-toolsets="list_user_repos,get_file_content"

注：

• 如果两者都有 enabled-toolsets 和 disabled-toolsets 被指定， enabled-toolsets 优先
• 工具名称区分大小写

按请求工具筛选（HTTP标头）

使用远程MCP服务器（HTTP/SSE传输）时，您可以通过HTTP标头根据每个请求动态筛选可用工具。这对于需要在不重新启动服务器的情况下对工具暴露进行细粒度控制的客户端非常有用。

1. 通过标题启用指定工具（白名单）：

- 使用 X-MCP-Enabled-Tools 头球 - 只有列出的工具才能用于该请求 - 例子： X-MCP-Enabled-Tools: list_user_repos,get_file_content

1. 通过表头禁用指定工具（黑名单）：

- 使用 X-MCP-Disabled-Tools 头球 - 所列工具将针对该请求禁用 - 例子： X-MCP-Disabled-Tools: create_repo,delete_repo

优先级规则：

• 如果两者都有 X-MCP-Enabled-Tools 和 X-MCP-Disabled-Tools 存在于同一请求白名单中(X-MCP-Enabled-Tools)优先
• 工具名称区分大小写

Cursor/Claude的配置示例：

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer ",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取更多详细信息。

可用工具

服务器提供了各种与Gitee交互的工具：

贡献

我们欢迎开源社区的贡献！如果你想为这个项目做出贡献，请遵循以下准则：

1. 分叉存储库。
2. 为您的功能或错误修复创建一个新分支。
3. 进行更改并确保代码有良好的文档记录。
4. 提交一个拉取请求，明确描述您的更改。

有关更多信息，请参阅 贡献 文件。