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

Clonar este repositorio
Instalar dependencias:

pip install -r requirements.txt

Ejecute el servidor MCP en modo de desarrollo:

mcp dev localdb_app.py

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

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.

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"

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

Descargar Claude Desktop desde:

https://claude.ai/descargar

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

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.

Reinicie Claude Desktop.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Un servidor de demostración que muestra la implementación de MCP en Python con manejo de recursos, operaciones de herramientas y avisos reutilizables para un sistema de usuario/publicación simple con base de datos local.

Related MCP Servers

Lodestar MCP Server
kanlanc
-
security
F
license
-
quality
This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
Last updated -
Python
Python REPL MCP Server
hdresearch
A
security
A
license
A
quality
A server that provides a persistent Python REPL environment through the MCP protocol, allowing execution of Python code, variable management, and package installation.
Last updated -
3
24
Python
MIT License
MCP Builder
XD3an
-
security
F
license
-
quality
A Python-based server that helps users easily install and configure other MCP servers across different platforms.
Last updated -
2
Python
Python MCP Server Template
nictuku
-
security
A
license
-
quality
A template repository for creating custom Model Context Protocol (MCP) servers in Python that can be integrated with applications like Claude Desktop or Cursor.
Last updated -
5
Python
MIT License

View all related MCP servers

MCP Python Tutorial