Servidor MCP de Gitee

Deje que la IA gestione los repositorios/problemas/solicitudes de extracción de Gitee por usted a través de MCP

Versión del nodo Versión NPM Docker Pulls Versión de la imagen de Docker LICENCIA insignia de herrería

Operaciones de IA compatibles

Categoría	Herramienta MCP	Descripción
Operaciones del repositorio	`create_repository`	Crear un repositorio Gitee
	`fork_repository`	Bifurcar un repositorio de Gitee
Operaciones de sucursal	`create_branch`	Crear una nueva rama en un repositorio de Gitee
	`list_branches`	Listar ramas en un repositorio de Gitee
	`get_branch`	Obtener detalles de una rama específica en un repositorio de Gitee
Operaciones con archivos	`get_file_contents`	Obtener el contenido de un archivo o directorio en un repositorio de Gitee
	`create_or_update_file`	Crear o actualizar un archivo en un repositorio de Gitee
	`push_files`	Enviar varios archivos a un repositorio de Gitee
Operaciones de emisión	`create_issue`	Crear un problema en un repositorio de Gitee
	`list_issues`	Lista de problemas en un repositorio de Gitee
	`get_issue`	Obtener detalles de un problema específico en un repositorio de Gitee
	`update_issue`	Actualizar un problema en un repositorio de Gitee
	`add_issue_comment`	Agregar un comentario a un problema en un repositorio de Gitee
Operaciones de solicitud de extracción	`create_pull_request`	Crear una solicitud de extracción en un repositorio de Gitee
	`list_pull_requests`	Listar solicitudes de extracción en un repositorio de Gitee
	`get_pull_request`	Obtener detalles de una solicitud de extracción específica en un repositorio de Gitee
	`update_pull_request`	Actualizar una solicitud de extracción en un repositorio de Gitee
	`merge_pull_request`	Fusionar una solicitud de extracción en un repositorio de Gitee
Operaciones de usuario	`get_user`	Obtener información de usuario de Gitee
	`get_current_user`	Obtenga información de usuario autenticado de Gitee

Related MCP server: Git Forensics MCP

Uso

Instalación mediante herrería

Para instalar Gitee MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Configuración

GITEE_API_BASE_URL : Opcional, punto final de Gitee OpenAPI, el valor predeterminado es https://gitee.com/api/v5
GITEE_PERSONAL_ACCESS_TOKEN : Obligatorio, token de acceso personal (PAT) de la cuenta de Gitee, se puede obtener desde la configuración de la cuenta de Gitee Tokens de acceso personal
DEBUG : Opcional, configúrelo como true para habilitar el registro de depuración, el valor predeterminado está deshabilitado

Ejecutar el servidor MCP a través de NPX

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

Ejecutar el servidor MCP a través del contenedor Docker

Obtener imagen de Docker

# Get from DockerHub docker pull normalcoder/gitee-mcp-server # Build locally docker build -t normalcoder/gitee-mcp-server .

Configurar el servidor 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>" } } } }

Guía de desarrollo

Instalar dependencias

npm install

Construir

npm run build

Después de una compilación exitosa, /dist contendrá el servidor MCP ejecutable.

Ejecutar servidor

npm start

El servidor MCP se ejecutará en stdio, lo que permitirá que los clientes MCP lo utilicen como un subproceso.

Crear imagen de Docker

También puedes ejecutar el servidor usando Docker:

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

Ejecutar el servidor MCP con Docker:

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

Depurar el servidor MCP

Puede utilizar @modelcontextprotocol/inspector para depurar:

Cree un archivo .env en el directorio raíz para las variables de entorno:

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

Ejecute la herramienta de depuración para iniciar el servicio y la interfaz de depuración web:

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

El proyecto incluye una función debug() para imprimir información de depuración, uso:

import { debug } from './common/utils.js'; debug('Message to log'); debug('Message with data:', { key: 'value' });

Los registros de depuración solo se imprimen cuando la variable de entorno DEBUG está establecida en true .

Dependencias

@modelcontextprotocol/sdk : SDK de MCP para implementación de servidor
universal-user-agent : para generar cadenas de agente de usuario
zod : Para la validación del esquema
zod-to-json-schema : para convertir esquemas Zod en esquemas JSON

Licencia

Con licencia MIT. Puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de licencia en el repositorio del proyecto.