星战科技xingzhan.cloud
返回市场
码云MCP服务器

码云MCP服务器

作者：normal-coder7 星标更新：2025-03-17
安装使用来源：spider==github.com

项目介绍

Gitee MCP Server

通过MCP让AI为您操作Gitee仓库/问题/拉取请求

Node 版本 NPM 版本 Docker 拉取次数 Docker 镜像版本 LICENSE smithery 徽章

<img width="380" height="200" src="https://gips0.baidu.com/it/u=3475010449,999509300&fm=3081&app=3081&f=PNG?w=760&h=400" />

支持的AI操作

类别MCP工具描述
仓库操作create_repository创建一个Gitee仓库
fork_repository分叉一个Gitee仓库
分支操作create_branch在Gitee仓库中创建一个新的分支
list_branches列出Gitee仓库中的所有分支
get_branch获取Gitee仓库中特定分支的详细信息
文件操作get_file_contents获取Gitee仓库中文件或目录的内容
create_or_update_file在Gitee仓库中创建或更新一个文件
push_files将多个文件推送到Gitee仓库
问题操作create_issue在Gitee仓库中创建一个问题
list_issues列出Gitee仓库中的所有问题
get_issue获取Gitee仓库中特定问题的详细信息
update_issue更新Gitee仓库中的一个问题
add_issue_comment在Gitee仓库的问题上添加评论
拉取请求操作create_pull_request在Gitee仓库中创建一个拉取请求
list_pull_requests列出Gitee仓库中的所有拉取请求
get_pull_request获取Gitee仓库中特定拉取请求的详细信息
update_pull_request更新Gitee仓库中的一个拉取请求
merge_pull_request合并Gitee仓库中的一个拉取请求
用户操作get_user获取Gitee用户信息
get_current_user获取已认证的Gitee用户信息

使用方法

通过Smithery安装

要通过Smithery自动安装Gitee MCP Server到Claude Desktop：

npx -y @smithery/cli install @normal-coder/gitee-mcp-server --client claude

配置

  • GITEE_API_BASE_URL: 可选，Gitee OpenAPI端点，默认是https://gitee.com/api/v5
  • GITEE_PERSONAL_ACCESS_TOKEN: 必需，Gitee账户个人访问令牌（PAT），可以从Gitee账户设置中的个人访问令牌获取
  • DEBUG: 可选，设置为true以启用调试日志，默认关闭

通过NPX运行MCP服务器

{
  "mcpServers": {
    "Gitee": {
      "command": "npx",
      "args": [
        "-y",
        "gitee-mcp-server"
      ],
      "env": {
        "GITEE_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

通过Docker容器运行MCP服务器

  1. 获取Docker镜像
# 从DockerHub获取
docker pull normalcoder/gitee-mcp-server

# 本地构建
docker build -t normalcoder/gitee-mcp-server .
  1. 配置MCP服务器
{
  "mcpServers": {
    "Gitee": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITEE_PERSONAL_ACCESS_TOKEN",
        "normalcoder/gitee-mcp-server"
      ],
      "env": {
        "GITEE_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

开发指南

安装依赖

npm install

构建

npm run build

成功构建后，/dist将包含可运行的MCP服务器。

运行服务器

npm start

MCP服务器将在标准I/O上运行，允许被MCP客户端作为子进程使用。

构建Docker镜像

您也可以使用Docker运行服务器：

docker build -t normalcoder/gitee-mcp-server .

使用Docker运行MCP服务器：

docker run -e GITEE_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> normalcoder/gitee-mcp-server

调试MCP服务器

您可以使用@modelcontextprotocol/inspector进行调试：

在根目录下创建一个.env文件用于环境变量：

GITEE_API_BASE_URL=https://gitee.com/api/v5
GITEE_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN>

运行调试工具以启动服务和Web调试界面：

npx @modelcontextprotocol/inspector npm run start --env-file=.env

项目中包含一个debug()函数用于打印调试信息，用法如下：

import { debug } from './common/utils.js';

debug('需要记录的消息');
debug('带有数据的消息:', { key: 'value' });

只有当DEBUG环境变量设置为true时才会打印调试日志。

依赖项

  • @modelcontextprotocol/sdk: 用于服务器实现的MCP SDK
  • universal-user-agent: 用于生成用户代理字符串
  • zod: 用于模式验证
  • zod-to-json-schema: 用于将Zod模式转换为JSON模式

许可证

根据MIT许可证授权。您可以在遵守MIT许可证条款和条件的情况下自由使用、修改和分发该软件。更多详情，请参阅项目存储库中的LICENSE文件。

相关链接