django-mcpz

Desarrollo

Descripción

Cuando tu proyecto Django ya tiene modelos, consultas y lógica de negocio y un cliente MCP (un agente, un IDE o un chatbot) necesita usarlas como herramientas, montar el protocolo a mano te come el tiempo. Aquí creas un servidor con metadatos, le das una URL y registras funciones Python: el servidor se comporta como una vista síncrona más.

Defines nombre, versión e instrucciones, y puedes protegerlo con autenticación por token Bearer. Los parámetros y resultados se declaran con structs de msgspec, que también se encarga de serializar y deserializar JSON con rapidez. Cada herramienta es una función decorada que recibe el request de Django y un struct de entrada, y devuelve un struct de salida.

Qué encaja en el flujo diario

  • Consultar o filtrar el ORM y devolver recuentos u otros datos tipados.
  • Marcar una herramienta como de solo lectura cuando no modifica nada.
  • Reutilizar la autenticación que ya tengas en el proyecto, por ejemplo tokens Bearer.

El paquete está en PyPI, la documentación en Read the Docs y el código se publica con licencia MIT.

Tecnologías y temas

  • Django

    El servidor MCP se integra como una vista síncrona de tu proyecto

  • Herramientas

    Decoras funciones Python y las cuelgas del servidor con una descripción

  • MCP

    Implementa el Model Context Protocol para exponer herramientas a clientes

  • msgspec

    Defines schemas de parámetros y resultados y serializas JSON con rapidez

  • Tokens Bearer

    Puedes exigir autenticación por token en el servidor MCP