openEuler MCP Servers

Repositorio de openEuler MCP Servers, ¡las contribuciones son bienvenidas!

简体中文 | English

Introducción

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

Arquitectura de software

El directorio del repositorio incluye un directorio doc, utilizado para almacenar la documentación general de diversos tipos. Después, cada carpeta en servers es un MCP Server 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 server debe incluir los siguientes elementos en el nivel superior:

1. Archivo de configuración de MCP - incluye la información de configuración del MCP Server

2. Archivo de configuración de despliegue - incluye otros archivos de configuración relacionados

3. Directorio de código fuente - incluye el código de implementación específico del MCP Server y archivos de recursos relacionados

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

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 MCP Server en el cliente MCP.

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

La comunidad openEuler construirá cada MCP Server como un paquete RPM. Los usuarios pueden instalarlo directamente con yum install y usarlo. Próximamente disponible.

Inicio rápido: Cómo usar el MCP Python-SDK para escribir su propio servidor MCP Server

Configuración del entorno MCP

1. Instalar uv herramienta de gestión de Python

yum install -y uv

2. Instalar MCP

yum install -y python3-mcp

Codificación práctica

1. Elija una pequeña herramienta: oegitext

oegitext es una pequeña herramienta para interactuar con gitee, que se puede usar 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 openEuler-25.03 EPOL. 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 usando 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). Configure el modelo grande en la configuración; 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 MCP servers. 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 invocación del cliente MCP