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

Operaciones de IA compatibles

Related MCP server: mcp-gitee

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

1. Obtener imagen de Docker

# Get from DockerHub
docker pull normalcoder/gitee-mcp-server

# Build locally
docker build -t normalcoder/gitee-mcp-server .

2. 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.

Enlaces relacionados

• Protocolo de contexto modelo

• Casa rural