MCP: escribe un servidor y conéctalo
Al terminar esta sección, habrás escrito tu propio servidor MCP, y habrás hecho que myagent se conecte a él, descubra sus herramientas y las invoque. De paso, quedarás claro sobre qué problema resuelve MCP exactamente.
Primero el problema: cada herramienta que conectas hay que reescribirla
En el capítulo anterior escribimos las herramientas en agent.py. Pero si quieres que Claude Code, Cursor y tu propio Agent todos puedan consultar el repositorio de notas de la empresa, tendrás que escribirlo tres veces, en tres lugares, y además con formatos distintos.
MCP (Model Context Protocol, protocolo de contexto de modelo) existe precisamente para resolver esto: escribe la herramienta una vez, conviértela en un servidor MCP, y todos los programas compatibles con MCP podrán usarla directamente. La analogía oficial es: MCP es como el puerto USB-C de las aplicaciones de IA.
Tres roles
BuscarDentro de MCP…
Toca uno para ver.
El servidor puede ofrecer tres tipos de cosas: Tools (funciones que el modelo decide cuándo invocar), Resources (datos que la aplicación lee) y Prompts (plantillas de prompt que el usuario elige). Esta sección solo usa Tools. El formato de mensajes es JSON-RPC 2.0; una invocación de herramienta se ve así en el cable (texto original de la especificación):
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call",
"params": { "name": "get_weather", "arguments": { "location": "New York" } } }1. Escribe un servidor MCP
mcp_servers/notes_server.py (está en myagent.zip):
import json
from pathlib import Path
from mcp.server import MCPServer
NOTES = Path(__file__).with_name("notes.json")
mcp = MCPServer("notes")
def _load():
return json.loads(NOTES.read_text(encoding="utf-8")) if NOTES.exists() else []
@mcp.tool()
def add_note(text: str) -> str:
"""记下一条笔记。"""
notes = _load() + [text]
NOTES.write_text(json.dumps(notes, ensure_ascii=False), encoding="utf-8")
return f"已记下,共 {len(notes)} 条。"
@mcp.tool()
def search_notes(keyword: str) -> list[str]:
"""按关键词查找笔记,返回所有包含这个词的笔记。"""
return [n for n in _load() if keyword in n]
if __name__ == "__main__":
mcp.run()A diferencia del capítulo anterior, donde escribimos el JSON Schema a mano, aquí las anotaciones de tipo son el schema: text: str le dice al SDK que el parámetro es una cadena, y la docstring de la función es la descripción de la herramienta. mcp.run() no toma parámetros, y usa stdio (entrada/salida estándar) para comunicarse con el cliente.
Muchos tutoriales de internet usan FastMCP, que ya no funciona en la nueva versión
El SDK oficial de Python, a partir de 2.x, renombró FastMCP a MCPServer, y la ruta de importación antigua fue eliminada directamente. Si escribes from mcp.server.fastmcp import FastMCP siguiendo tutoriales antiguos, obtendrás ModuleNotFoundError: No module named 'mcp.server.fastmcp', y el mensaje de error sugerirá usar from mcp.server.mcpserver import MCPServer. Nosotros usamos mcp 2.3.0 (publicado el 2026-10-02). Si quieres ejecutar código antiguo, instala mcp<2.
2. Haz que el Agent se conecte a él
En el MCP SDK 2.x, el cliente tiene una sola clase, Client. Si le pasas un StdioServerParameters, iniciará el servidor como subproceso y se conectará vía stdio:
async def connect_mcp(command, stack):
from mcp import Client
from mcp.client.stdio import StdioServerParameters
parts = shlex.split(command)
mcp_client = await stack.enter_async_context(Client(StdioServerParameters(command=parts[0], args=parts[1:])))
listed = await mcp_client.list_tools()
tools = [{"type": "function", "function": {"name": t.name, "description": t.description or "",
"parameters": t.input_schema}} for t in listed.tools]
return mcp_client, toolsEl paso clave: convertir las herramientas listadas por el servidor MCP (nombre, descripción, schema de entrada) al formato tools que el modelo entiende, y entregarlas al modelo junto con las herramientas locales. Cuando el modelo solicite una invocación, si no es una herramienta local, se reenvía a MCP:
r = await mcp_client.call_tool(name, args)
result = "\n".join(getattr(c, "text", str(c)) for c in r.content)Ejecuta:
python agent.py --mcp "python mcp_servers/notes_server.py" "记一条笔记:周五下午三点和设计组评审消息通知的交互稿"
python agent.py --mcp "python mcp_servers/notes_server.py" "我记过哪些和设计组有关的事?"Deberías ver (salida real de qwen3:8b en esta máquina):
Servidor MCP conectado, nuevas herramientas: add_note, search_notes
[1] add_note({"text": "El viernes a las tres de la tarde, revisión del prototipo de interacción de notificaciones de mensajes con el equipo de diseño"})
Agent: Nota registrada: el viernes a las tres de la tarde, revisión del prototipo de interacción de notificaciones de mensajes con el equipo de diseño.Servidor MCP conectado, nuevas herramientas: add_note, search_notes
[1] search_notes({"keyword": "equipo de diseño"})
Agent: Se encontraron las siguientes notas relacionadas con el equipo de diseño:
- El viernes a las tres de la tarde, revisión del prototipo de interacción de notificaciones de mensajes con el equipo de diseñoEn el código de myagent no hay ni una línea sobre notas: todas las herramientas provienen del servidor MCP. El mismo notes_server.py también puede configurarse para que lo usen otros programas compatibles con MCP, como Claude Code.
Una trampa fácil de pisar: el subproceso del servidor iniciado por stdio no hereda todas tus variables de entorno, solo unas pocas como HOME y PATH. Si el servidor necesita una API Key, debes pasarla explícitamente en StdioServerParameters(env={...}).
3. Qué cambió en la nueva especificación
El número de versión de MCP es una fecha, que indica la última modificación no retrocompatible. La versión actual es 2026-07-28, y la anterior es 2025-11-25. Esta versión trae cambios importantes:
- El protocolo pasa a ser sin estado: se eliminó el handshake
initialize, cada solicitud lleva su propia información de versión y capacidades; se añadióserver/discovercomo obligatorio de implementar. - Streamable HTTP ya no tiene ID de sesión.
- Las tres funciones Roots, Sampling y Logging quedaron marcadas como obsoletas.
Así que los tutoriales de internet que hablan de "primero el handshake initialize" se refieren a la versión antigua. Al escribir código con el SDK apenas notas estos cambios: el SDK los maneja por ti.
MCP es ahora uno de los proyectos de la Agentic AI Foundation (AAIF), bajo la Linux Foundation.
4. Seguridad: las herramientas MCP son código de otros
La especificación lo deja muy claro: una herramienta equivale a ejecutar código arbitrario, y el host debe obtener el consentimiento explícito del usuario antes de invocar cualquier herramienta; las descripciones de las herramientas, salvo que provengan de un servidor de confianza, deben considerarse no confiables. Conecta solo los servidores MCP en los que confíes. Nuestro myagent, por simplicidad, no añadió confirmación para las herramientas MCP; en el último capítulo veremos cómo añadirla.
Pon a prueba tus conocimientos¿Cuál es el problema central que resuelve MCP?
Compruébalo
- Escribí notes_server.py e hice que myagent se conectara mediante
--mcp - Sé que FastMCP fue renombrado a MCPServer en el SDK 2.x
- Puedo nombrar el mayor cambio de la especificación 2026-07-28
Siguiente sección: Diferencias entre MCP, Function Calling, A2A y Skills.