MCP-guide

🔧 Guía de integración de MCP Server y Cline usando venv

✅ Resumen

Esta guía explica cómo utilizar un proyecto de muestra de MCP en GitHub, construir un servidor MCP en un entorno virtual de Python (venv) y conectarlo con la extensión de VS Code «Cline». También se realizará una verificación de funcionamiento con MCP Inspector.

1. Obtención del proyecto MCP

📦 1.1 Clonar el repositorio de GitHub

git clone https://github.com/m-hikichi/MCP-guide.git
cd MCP-guide

✅ ${PROJECT_DIR} = ruta completa de MCP-guide (ejemplo: C:/Users/yourname/Documents/MCP-guide)

2. Configuración del entorno virtual de Python

🐍 2.1 Crear el entorno virtual

python -m venv venv

🔁 2.2 Activar el entorno virtual

• Símbolo del sistema:

  .\venv\Scripts\activate.bat
  

• PowerShell:

  .\venv\Scripts\activate.ps1
  

3. Instalación de paquetes dependientes (usando requirements.txt)

Con el entorno virtual activado, ejecute la instalación usando requirements.txt incluido en el proyecto clonado:

pip install -r requirements.txt

✅ mcp[cli] y todos los demás paquetes necesarios están incluidos.

4. Inicio del servidor MCP y verificación con Inspector

🧪 4.1 Inicio de MCP Inspector

Ejecute el siguiente comando para iniciar MCP Inspector:

mcp dev mcp_server.py

Si tiene éxito, el navegador se abrirá automáticamente y se mostrará MCP Inspector.

• En la pestaña Tools puede probar funciones como add
• En la pestaña Resources puede verificar el acceso a recursos

5. Integración con la extensión Cline

⚙️ 5.1 Edición de cline_mcp_settings.json

Abra la paleta de comandos en VS Code, ejecute > Cline: Configure MCP Servers y agregue la siguiente configuración:

{
  "mcpServers": {
    "local_mcp_server": {
      "command": "${PROJECT_DIR}/venv/Scripts/mcp.exe",
      "args": [
        "dev",
        "${PROJECT_DIR}/mcp_server.py"
      ]
    }
  }
}

✅ Reemplace ${PROJECT_DIR} con la ruta completa del directorio MCP-guide
❌ No se permiten espacios en la ruta
✅ Se permite japonés en la ruta

6. Uso en Cline

1. Abra la vista de chat en VS Code
2. Cambie el servidor MCP a local_mcp_server
3. Realice llamadas a herramientas como add(a=2, b=3) y verifique que funcionen correctamente