Ejemplo de servidor MCP

Este repositorio contiene la implementación de un servidor de Protocolo de Contexto de Modelo (MCP) con fines educativos. Este código demuestra cómo construir un servidor MCP funcional que se integra con varios clientes LLM.

Para seguir el tutorial completo, consulte el videotutorial de YouTube .

¿Qué es MCP?

MCP (Protocolo de Contexto de Modelo) es un protocolo abierto que estandariza cómo las aplicaciones proporcionan contexto a los LLM. Piense en MCP como un puerto USB-C para aplicaciones de IA: proporciona una forma estandarizada de conectar los modelos de IA a diferentes fuentes de datos y herramientas.

Beneficios clave

• Una lista creciente de integraciones prediseñadas a las que su LLM puede conectarse directamente

• Flexibilidad para cambiar entre proveedores y vendedores de LLM

• Mejores prácticas para proteger sus datos dentro de su infraestructura

Related MCP server: Optimized Memory MCP Server V2

Descripción general de la arquitectura

MCP sigue una arquitectura cliente-servidor donde una aplicación host puede conectarse a múltiples servidores:

• Hosts MCP : programas como Claude Desktop, IDE o herramientas de IA que desean acceder a datos a través de MCP

• Clientes MCP : clientes de protocolo que mantienen conexiones 1:1 con servidores

• Servidores MCP : programas livianos que exponen capacidades específicas a través del Protocolo de Contexto de Modelo estandarizado

• Fuentes de datos : tanto locales (archivos, bases de datos) como servicios remotos (API) a los que pueden acceder los servidores MCP

Conceptos básicos de MCP

Los servidores MCP pueden proporcionar tres tipos principales de capacidades:

• Recursos : datos similares a archivos que los clientes pueden leer (como respuestas de API o contenido de archivos)

• Herramientas : Funciones que puede llamar el LLM (con aprobación del usuario)

• Indicaciones : Plantillas preescritas que ayudan a los usuarios a realizar tareas específicas

Requisitos del sistema

• Python 3.10 o superior

• MCP SDK 1.2.0 o superior

• administrador de paquetes uv

Empezando

Instalación del gestor de paquetes uv

En MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Asegúrese de reiniciar su terminal luego para garantizar que se detecte el comando uv .

Configuración del proyecto

1. Crear e inicializar el proyecto:

# Create a new directory for our project
uv init mcp-server
cd mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx

2. Cree el archivo de implementación del servidor:

touch main.py

Ejecución del servidor

1. Inicie el servidor MCP:

uv run main.py

2. El servidor se iniciará y estará listo para aceptar conexiones.

Conexión a Claude Desktop

1. Instalar Claude Desktop desde el sitio web oficial

2. Configure Claude Desktop para utilizar su servidor MCP:

Editar ~/Library/Application Support/Claude/claude_desktop_config.json :

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. Reiniciar Claude Desktop

Solución de problemas

Si Claude Desktop no detecta su servidor:

1. Verifique la ruta y los permisos del archivo de configuración

2. Verifique que la ruta absoluta en la configuración sea correcta

3. Asegúrese de que el sistema UV esté correctamente instalado y accesible.

4. Consulte los registros de Claude Desktop para ver si hay mensajes de error

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.