Servidor MCP de Gitee

El servidor MCP de Gitee es una implementación del Protocolo de Contexto de Modelo (MCP) para Gitee. Proporciona un conjunto de herramientas para interactuar con la API de Gitee, permitiendo a los asistentes de IA gestionar repositorios, incidencias, solicitudes de extracción (pull requests) y más.

Características

• Interactúa con repositorios, incidencias, solicitudes de extracción y notificaciones de Gitee

• URL base de la API configurable para admitir diferentes instancias de Gitee

• Argumentos de línea de comandos para una configuración sencilla

• Admite operaciones personales, de organización y empresariales

• Activación/desactivación dinámica de conjuntos de herramientas

1. Obtener las incidencias del repositorio

2. Implementar el código y crear una solicitud de extracción basada en los detalles de la incidencia

3. Comentar y cerrar la incidencia

Related MCP server: Gitea MCP Tool

Instalación (Este paso se puede omitir directamente al iniciar con npx)

Requisitos previos

• Go 1.23.0 o superior

• Cuenta de Gitee con un token de acceso, ir a obtenerlo

Compilación desde el código fuente

1. Clonar el repositorio:

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

2. Compilar el proyecto:

   make build

   Mover ./bin/mcp-gitee a la variable de entorno PATH

Usar go install

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

Uso

Comprobar la versión de mcp-gitee:

mcp-gitee --version

Configuración de hosts MCP

Ejemplo de configuración: Haga clic para ver más configuraciones de aplicaciones

• Conectar al servidor remoto oficial mcp-gitee (no requiere instalación)

{
  "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>"
      }
    }
  }
}

• ejecutable

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

Opciones de línea de comandos

• --token: Token de acceso de Gitee

• --api-base: URL base de la API de Gitee (predeterminado: https://gitee.com/api/v5)

• --version: Mostrar información de la versión

• --transport: Tipo de transporte (stdio, sse o http, predeterminado: stdio)

• --address: El host y puerto en el que iniciar el servidor (predeterminado: localhost:8000)

• --enabled-toolsets: Lista separada por comas de herramientas a habilitar (si se especifica, solo se habilitarán estas herramientas)

• --disabled-toolsets: Lista separada por comas de herramientas a deshabilitar

Variables de entorno

También puede configurar el servidor mediante variables de entorno:

• GITEE_ACCESS_TOKEN: Token de acceso de Gitee

• GITEE_API_BASE: URL base de la API de Gitee

• ENABLED_TOOLSETS: Lista separada por comas de herramientas a habilitar

• DISABLED_TOOLSETS: Lista separada por comas de herramientas a deshabilitar

Gestión de conjuntos de herramientas

La gestión de conjuntos de herramientas admite dos modos:

1. Habilitar herramientas específicas (modo lista blanca):

   • Use el parámetro --enabled-toolsets o la variable de entorno ENABLED_TOOLSETS

   • Después de especificar, solo se habilitarán las herramientas listadas, las demás se deshabilitarán

   • Ejemplo: --enabled-toolsets="list_user_repos,get_file_content"

2. Deshabilitar herramientas específicas (modo lista negra):

   • Use el parámetro --disabled-toolsets o la variable de entorno DISABLED_TOOLSETS

   • Después de especificar, las herramientas listadas se deshabilitarán, las demás se habilitarán

   • Ejemplo: --disabled-toolsets="list_user_repos,get_file_content"

Nota:

• Si se especifican tanto enabled-toolsets como disabled-toolsets, enabled-toolsets tiene prioridad

• Los nombres de las herramientas distinguen entre mayúsculas y minúsculas

Licencia

Este proyecto está bajo la Licencia MIT. Consulte el archivo LICENSE para obtener más detalles.

Herramientas disponibles

El servidor proporciona varias herramientas para interactuar con Gitee:

Contribución

¡Damos la bienvenida a las contribuciones de la comunidad de código abierto! Si desea contribuir a este proyecto, siga estas pautas:

1. Haga un fork del repositorio.

2. Cree una nueva rama para su función o corrección de errores.

3. Realice sus cambios y asegúrese de que el código esté bien documentado.

4. Envíe una solicitud de extracción con una descripción clara de sus cambios.

Para obtener más información, consulte el archivo CONTRIBUTING.