openEuler MCP Servers

Repositorio de openEuler MCP Servers, todos son bienvenidos a contribuir

Introducción

MCP es la abreviatura de Model Context Protocol, que tiene como objetivo proporcionar un protocolo de contexto universal para grandes modelos, utilizado para invocar diversas aplicaciones y ampliar las capacidades de los grandes modelos. El repositorio mcp-servers de openEuler se utiliza para almacenar varios servidores MCP, centrándose en el campo de los sistemas operativos, combinando Devstation y EulerCopilot para mejorar la experiencia de interacción de openEuler.

Arquitectura de software

El directorio del repositorio incluye un directorio doc, que se utiliza para almacenar la documentación general de varios tipos. Después, cada carpeta en servers es un servidor MCP independiente.

mcp-servers/
├── servers
│   ├── oeDeploys/
│   │   ├── mcp_config.json
│   │   ├── mcp-rpm.yaml
│   │   └── src/
│   │       ├── icon.png
│   │       ├── mcp-oedp.py
│   │       ├── readme.md
│   │       └── requirements.txt
│   ├── oeGitExt/
│   └── xxxxx/
├── scripts/
└── doc/

Tomando oeDeploy como ejemplo, cada servidor debe incluir los siguientes contenidos en el nivel superior:

1. Archivo de configuración de MCP: contiene la información de configuración del servidor MCP.

2. Archivo de configuración de despliegue: contiene otros archivos de configuración relacionados.

3. Directorio de código fuente: contiene el código de implementación específico del servidor MCP y los archivos de recursos relacionados.

El documento de descripción de MCP en doc proporciona sugerencias de descripción para los servidores MCP, con el fin de mejorar su facilidad de uso.

Instrucciones de uso

1. Utilice clientes MCP comunes para completar la configuración, como EulerCopilot, Roo Code, Cline, etc.

2. Escriba el archivo de configuración del servidor MCP en el cliente MCP.

Instalación automática con yum (recomendado):

La comunidad de openEuler construirá cada servidor MCP como un paquete RPM. Los usuarios pueden instalarlo directamente con yum install, y estará disponible próximamente.

Inicio rápido: Cómo escribir su propio servidor MCP usando el SDK de Python de MCP

Configuración del entorno MCP

1. Instalar la herramienta de gestión de Python uv

yum install -y uv

2. Instalar MCP

yum install -y python3-mcp

Codificación práctica

1. Elegir una pequeña herramienta: oegitext

oegitext es una pequeña herramienta para interactuar con gitee, que se puede utilizar para consultar algunos repositorios e issues en gitee, así como información de PR: Esta herramienta está preinstalada en DevStation. Si no está instalada, puede usar yum install oegitext安装 después de configurar el repositorio EPOL de openEuler-25.03. Después de la instalación, use el siguiente comando para configurar el token de gitee:

oegitext config -token ${access_token}

Luego use oegitext show issue -p para consultar el issue actual:

2. Realizar una modificación con python-sdk

En el entorno virtual creado anteriormente con uv, cree un nuevo archivo oegitext_mcp.py. A continuación se muestra un ejemplo simple del código:

import subprocess
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("查找openEuler社区的issue")

@mcp.tool()
def get_my_openeuler_issue() -> str:
    """统计我在openEuler社区所负责的issue"""
    try:
        # 执行oegitext命令并解析结果
        result = subprocess.check_output(['oegitext', 'show', 'issue', '-p'], 
                                        text=True, 
                                        stderr=subprocess.STDOUT)
        
        return result
    except subprocess.CalledProcessError as e:
        return e
    except Exception as e:
        return e

if __name__ == "__main__":
    # Initialize
    mcp.run()

3. Configuración del entorno MCP de openEuler

Abra el software vscodium preinstalado en DevStation, instale Roo Code en el mercado de complementos (posteriormente también se puede implementar con EulerCopilot). En la configuración, configure el modelo grande. Usamos la API de DeepSeek V3:

API提供商：OpenAI Compatible
OpenAI基础URL：https://api.siliconflow.cn
密钥：对应的密钥
模型：Pro/deepseek-ai/DeepSeek-V3   #可以自己选择合适的模型

En la pestaña superior del complemento Roo Code, seleccione Servidor MCP. Haga clic en Editar MCP global.

{
  "mcpServers": {
    "oegitext_mcp": {
      "command": "/usr/bin/uv",
      "args": [
        "--directory",
        "/home/xxx/oegitext_mcp",
        "run",
        "--python",
        "/usr/bin/python3",
        "oegitext_mcp.py"
      ],
      "disabled": false,
      "autoApprove": [],
      "alwaysAllow": []
    },
  }
}

Cambie la ruta anterior a la ruta real correcta, luego guarde y haga clic en Finalizar.

4. Efecto de la llamada del cliente MCP