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.

Diagrama MCP

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

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

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

Cree el archivo de implementación del servidor:

touch main.py

Ejecución del servidor

Inicie el servidor MCP:

uv run main.py

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

Conexión a Claude Desktop

Instalar Claude Desktop desde el sitio web oficial
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"
            ]
        }
    }
}

Reiniciar Claude Desktop

Solución de problemas

Si Claude Desktop no detecta su servidor:

Verifique la ruta y los permisos del archivo de configuración
Verifique que la ruta absoluta en la configuración sea correcta
Asegúrese de que el sistema UV esté correctamente instalado y accesible.
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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

get_docs

Una implementación educativa de un servidor de Protocolo de Contexto de Modelo que demuestra cómo construir un servidor MCP funcional para integrarse con varios clientes LLM como Claude Desktop.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-framework-starter
QuantGeekDev
-
security
F
license
-
quality
A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
Last updated -
2
TypeScript
MCP Server Boilerplate
cds-id
-
security
F
license
-
quality
A ready-to-use starter implementation of the Model Context Protocol (MCP) server that enables applications to provide standardized context for LLMs with sample resources, tools, and prompts.
Last updated -
TypeScript
MCP Server Sample
antonioscapellato
-
security
A
license
-
quality
An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server integrating with various LLM clients.
Last updated -
2
Python
MIT License
my-mcp-server
15972289829
A
security
F
license
A
quality
A Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.
Last updated -
677
TypeScript

View all related MCP servers

Appeared in Searches

Latest Next.js Documentation

MCP Server Example