Tutorial de Python de MCP

Aplicación tutorial para MCP en Python con una base de datos local simple y datos simulados

Instalación y ejecución

Instalación mediante herrería

Para instalar Python MCP Tutorial Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @jhj0517/mcp-python-tutorial --client claude

Instalación manual

1. Clonar este repositorio

2. Instalar dependencias:

pip install -r requirements.txt

3. Ejecute el servidor MCP en modo de desarrollo:

mcp dev localdb_app.py

4. El puerto predeterminado para el servidor MCP es 5173 Acceso a http://localhost:5173 .

Related MCP server: xmcp Demo Application

Características de MCP

Esta aplicación tutorial muestra los conceptos básicos de MCP. Puedes consultar las anotaciones por rol en tutorial_app/mcp_server.py :

@mcp.resource

Básicamente, esta anotación se trata de que el agente "obtenga" el recurso, al igual que GET en RESTAPI.

• users://all - Obtener todos los usuarios

• users://{user_id}/profile - Obtener el perfil de un usuario

• posts://all - Obtener todas las publicaciones

• posts://{post_id} - Obtener una publicación por ID

@mcp.tool

Se trata de que el agente "genere" el nuevo recurso, al igual que POST en RESTAPI.

• create_user - Crea un nuevo usuario

• create_post - Crea una nueva publicación

• search_posts - Buscar publicaciones por título o contenido

@mcp.prompt

Esta es solo una plantilla reutilizable para interactuar con LLM cómodamente.

• user_profile_analysis - Generar análisis del perfil de un usuario

• post_feedback - Mensaje interactivo para comentarios de publicaciones

[!NOTA] Para más anotaciones, lea: https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#core-concepts

Conectando con el cliente

Una vez configurado el servidor MCP, necesitará un cliente LLM que lo use para crear su agente. La siguiente guía le ayudará a conectar con Claude Desktop como cliente.

1. Claude Desktop usa uv para instalar las dependencias del servidor MCP. Primero, instale uv :

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Instalar las dependencias del servidor MCP usando uv :

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

uv pip install -r requirements.txt

3. Descargar Claude Desktop desde:

• https://claude.ai/descargar

4. Localice o cree el archivo claude_desktop_config.json . La ubicación varía según el sistema operativo:

• Ventanas:

C:\Users\%USER%\AppData\Roaming\Claude\claude_desktop_config.json

• MacOS/Linux:

~/Library/Application\ Support/Claude/claude_desktop_config.json

5. Agregue el atributo mcpServers a su claude_desktop_config.json :

{
    "mcpServers": {
        "local_db": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "localdb_app.py"
            ]
        }
    }
}

Nota: Puede implementar varios servidores MCP, cada uno con sus propias responsabilidades y experiencia. Esta separación de responsabilidades es mejor que implementar todo en un solo servidor MCP.

6. Reinicie Claude Desktop.