Communitygithub.com

agencelutie/LP-lutie

Guía para crear servidores MCP (Model Context Protocol) de alta calidad que permiten a los LLM interactuar con servicios externos a través de herramientas bien diseñadas. Úsalo al construir servidores MCP para integrar API o servicios externos, ya sea en Python (FastMCP) o Node/TypeScript (MCP SDK).

¿Qué es LP-lutie?

Esta habilidad proporciona una guía completa y estructurada para el desarrollo de servidores MCP (Protocolo de Contexto de Modelo), un estándar emergente que permite a modelos de lenguaje grandes (LLMs) interactuar de forma segura y eficiente con API y servicios externos. La guía detalla un flujo de trabajo de cuatro fases que abarca desde la investigación y planificación inicial, pasando por la implementación práctica con TypeScript o Python, hasta la revisión, pruebas y creación de evaluaciones. Se enfatiza la importancia de un diseño centrado en el agente, con herramientas de nombres claros, descripciones concisas, manejo de errores accionable y un balance entre cobertura completa de API y herramientas de flujo de trabajo especializadas. El objetivo final es crear servidores MCP que no solo sean técnicamente sólidos, sino que también maximicen la capacidad de los LLMs para resolver tareas del mundo real de manera autónoma y efectiva, y proporciona un método para verificar esa efectividad mediante la creación de evaluaciones complejas y realistas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/agencelutie/LP-lutie/tree/main/skills-export/examples/mcp-builder
Ver original→Ver todas las habilidades

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentación

Guía de Desarrollo de Servidores MCP

Resumen

Crea servidores MCP (Model Context Protocol) que permitan a los LLM interactuar con servicios externos a través de herramientas bien diseñadas. La calidad de un servidor MCP se mide por qué tan bien permite a los LLM realizar tareas del mundo real.

Proceso

🚀 Flujo de Trabajo de Alto Nivel

Crear un servidor MCP de alta calidad implica cuatro fases principales:

Fase 1: Investigación y Planificación Profunda

1.1 Comprender el Diseño Moderno de MCP

Cobertura de API vs. Herramientas de Flujo de Trabajo: Equilibra la cobertura completa de endpoints de API con herramientas de flujo de trabajo especializadas. Las herramientas de flujo de trabajo pueden ser más convenientes para tareas específicas, mientras que la cobertura completa brinda a los agentes flexibilidad para componer operaciones. El rendimiento varía según el cliente: algunos clientes se benefician de la ejecución de código que combina herramientas básicas, mientras que otros funcionan mejor con flujos de trabajo de alto nivel. Cuando tengas dudas, prioriza la cobertura completa de la API.

Nombres y Descubribilidad de Herramientas: Los nombres de herramientas claros y descriptivos ayudan a los agentes a encontrar las herramientas adecuadas rápidamente. Usa prefijos consistentes (por ejemplo, github_create_issue, github_list_repos) y nombres orientados a la acción.

Gestión de Contexto: Los agentes se benefician de descripciones concisas de herramientas y la capacidad de filtrar/paginar resultados. Diseña herramientas que devuelvan datos enfocados y relevantes. Algunos clientes admiten la ejecución de código, lo que puede ayudar a los agentes a filtrar y procesar datos de manera eficiente.

Mensajes de Error Accionables: Los mensajes de error deben guiar a los agentes hacia soluciones con sugerencias específicas y próximos pasos.

1.2 Estudiar la Documentación del Protocolo MCP

Navega por la especificación MCP:

Comienza con el mapa del sitio para encontrar páginas relevantes: https://modelcontextprotocol.io/sitemap.xml

Luego obtén páginas específicas con el sufijo .md para formato markdown (por ejemplo, https://modelcontextprotocol.io/specification/draft.md).

Páginas clave a revisar:

  • Resumen de la especificación y arquitectura
  • Mecanismos de transporte (HTTP transmisible, stdio)
  • Definiciones de herramientas, recursos y prompts

1.3 Estudiar la Documentación del Framework

Stack recomendado:

  • Lenguaje: TypeScript (soporte SDK de alta calidad y buena compatibilidad en muchos entornos de ejecución, por ejemplo, MCPB. Además, los modelos de IA son buenos generando código TypeScript, beneficiándose de su uso generalizado, tipado estático y buenas herramientas de linting)
  • Transporte: HTTP transmisible para servidores remotos, usando JSON sin estado (más simple de escalar y mantener, en comparación con sesiones con estado y respuestas en streaming). stdio para servidores locales.

Cargar documentación del framework:

Para TypeScript (recomendado):

  • SDK de TypeScript: Usa WebFetch para cargar https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md
  • ⚡ Guía de TypeScript - Patrones y ejemplos de TypeScript

Para Python:

  • SDK de Python: Usa WebFetch para cargar https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md
  • 🐍 Guía de Python - Patrones y ejemplos de Python

1.4 Planificar tu Implementación

Comprender la API: Revisa la documentación de la API del servicio para identificar endpoints clave, requisitos de autenticación y modelos de datos. Usa la búsqueda web y WebFetch según sea necesario.

Selección de Herramientas: Prioriza la cobertura completa de la API. Enumera los endpoints a implementar, comenzando con las operaciones más comunes.

Fase 2: Implementación

2.1 Configurar la Estructura del Proyecto

Consulta las guías específicas del lenguaje para la configuración del proyecto:

2.2 Implementar la Infraestructura Principal

Crea utilidades compartidas:

  • Cliente API con autenticación
  • Ayudantes de manejo de errores
  • Formateo de respuestas (JSON/Markdown)
  • Soporte de paginación

2.3 Implementar Herramientas

Para cada herramienta:

Esquema de Entrada:

  • Usa Zod (TypeScript) o Pydantic (Python)
  • Incluye restricciones y descripciones claras
  • Agrega ejemplos en las descripciones de los campos

Esquema de Salida:

  • Define outputSchema cuando sea posible para datos estructurados
  • Usa structuredContent en las respuestas de las herramientas (característica del SDK de TypeScript)
  • Ayuda a los clientes a comprender y procesar las salidas de las herramientas

Descripción de la Herramienta:

  • Resumen conciso de la funcionalidad
  • Descripciones de los parámetros
  • Esquema del tipo de retorno

Implementación:

  • Async/await para operaciones de E/S
  • Manejo adecuado de errores con mensajes accionables
  • Soporte de paginación donde sea aplicable
  • Devuelve tanto contenido de texto como datos estructurados cuando se usen SDKs modernos

Anotaciones:

  • readOnlyHint: true/false
  • destructiveHint: true/false
  • idempotentHint: true/false
  • openWorldHint: true/false

Fase 3: Revisión y Pruebas

3.1 Calidad del Código

Revisa para:

  • Sin código duplicado (principio DRY)
  • Manejo de errores consistente
  • Cobertura completa de tipos
  • Descripciones claras de herramientas

3.2 Compilación y Pruebas

TypeScript:

  • Ejecuta npm run build para verificar la compilación
  • Prueba con MCP Inspector: npx @modelcontextprotocol/inspector

Python:

  • Verifica la sintaxis: python -m py_compile your_server.py
  • Prueba con MCP Inspector

Consulta las guías específicas del lenguaje para enfoques de prueba detallados y listas de verificación de calidad.

Fase 4: Crear Evaluaciones

Después de implementar tu servidor MCP, crea evaluaciones exhaustivas para probar su efectividad.

Carga la ✅ Guía de Evaluación para obtener pautas completas de evaluación.

4.1 Comprender el Propósito de la Evaluación

Usa evaluaciones para probar si los LLM pueden usar efectivamente tu servidor MCP para responder preguntas complejas y realistas.

4.2 Crear 10 Preguntas de Evaluación

Para crear evaluaciones efectivas, sigue el proceso descrito en la guía de evaluación:

  1. Inspección de Herramientas: Enumera las herramientas disponibles y comprende sus capacidades
  2. Exploración de Contenido: Usa operaciones DE SOLO LECTURA para explorar los datos disponibles
  3. Generación de Preguntas: Crea 10 preguntas complejas y realistas
  4. Verificación de Respuestas: Resuelve cada pregunta tú mismo para verificar las respuestas

4.3 Requisitos de Evaluación

Asegúrate de que cada pregunta sea:

  • Independiente: No dependiente de otras preguntas
  • Solo lectura: Solo se requieren operaciones no destructivas
  • Compleja: Requiere múltiples llamadas a herramientas y exploración profunda
  • Realista: Basada en casos de uso reales que interesarían a los humanos
  • Verificable: Respuesta única y clara que pueda verificarse mediante comparación de cadenas
  • Estable: La respuesta no cambiará con el tiempo

4.4 Formato de Salida

Crea un archivo XML con esta estructura:

<evaluation>
  <qa_pair>
    <question>Encuentra discusiones sobre lanzamientos de modelos de IA con nombres en clave de animales. Un modelo necesitaba una designación de seguridad específica que usa el formato ASL-X. ¿Qué número X se estaba determinando para el modelo que lleva el nombre de un gato salvaje manchado?</question>
    <answer>3</answer>
  </qa_pair>
<!-- Más qa_pairs... -->
</evaluation>

Archivos de Referencia

📚 Biblioteca de Documentación

Carga estos recursos según sea necesario durante el desarrollo:

Documentación Principal de MCP (Cargar Primero)

  • Protocolo MCP: Comienza con el mapa del sitio en https://modelcontextprotocol.io/sitemap.xml, luego obtén páginas específicas con el sufijo .md
  • 📋 Mejores Prácticas MCP - Pautas universales de MCP que incluyen:
    • Convenciones de nombres de servidores y herramientas
    • Pautas de formato de respuesta (JSON vs Markdown)
    • Mejores prácticas de paginación
    • Selección de transporte (HTTP transmisible vs stdio)
    • Estándares de seguridad y manejo de errores

Documentación del SDK (Cargar Durante la Fase 1/2)

  • SDK de Python: Obtén de https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md
  • SDK de TypeScript: Obtén de https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md

Guías de Implementación Específicas del Lenguaje (Cargar Durante la Fase 2)

  • 🐍 Guía de Implementación en Python - Guía completa de Python/FastMCP que incluye:

    • Patrones de inicialización del servidor
    • Ejemplos de modelos Pydantic
    • Registro de herramientas con @mcp.tool
    • Ejemplos completos funcionales
    • Lista de verificación de calidad

  • ⚡ Guía de Implementación en TypeScript - Guía completa de TypeScript que incluye:

    • Estructura del proyecto
    • Patrones de esquema Zod
    • Registro de herramientas con server.registerTool
    • Ejemplos completos funcionales
    • Lista de verificación de calidad

Guía de Evaluación (Cargar Durante la Fase 4)

  • ✅ Guía de Evaluación - Guía completa de creación de evaluaciones que incluye:
    • Pautas para la creación de preguntas
    • Estrategias de verificación de respuestas
    • Especificaciones de formato XML
    • Ejemplos de preguntas y respuestas
    • Ejecución de una evaluación con los scripts proporcionados

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

agencelutie/LP-lutie

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

agencelutie/LP-lutie

Submit expense reimbursements through Benepass (app.getbenepass.com). For users whose employer uses Benepass as their benefits platform. Handles login, benefit selection, form filling, receipt upload, and submission. Requires browser/computer-use capabilities.

agencelutie/LP-lutie

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

agencelutie/LP-lutie

Make a phone call to book an appointment or reservation. Checks calendar first, gets explicit consent before dialing, discloses AI identity on the call, and adds the booking to calendar when done.

agencelutie/LP-lutie

Cancel a subscription or unsubscribe from a service. Works from a description, a pasted charge line, a URL, or a photo/screenshot. Can also audit a full statement for recurring charges and cancel several at once. Finds the right contact method and handles the cancellation — including phone calls.

agencelutie/LP-lutie

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

agencelutie/LP-lutie

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

agencelutie/LP-lutie

Help plan an event — from a birthday dinner to a wedding. Scales to the size of the occasion. Handles venue research, guest lists, timelines, vendors, and budgets.

agencelutie/LP-lutie

Help submit an expense or reimbursement on any platform. Detects the right tool (Benepass, Brex, Concur, Expensify, etc.), finds receipts, checks for duplicates, and walks through submission.

agencelutie/LP-lutie

Handle small bureaucratic tasks — jury duty responses, parking tickets, passport renewals, DMV forms, permit applications, and other government or administrative paperwork.

agencelutie/LP-lutie

Run financial calculations and scenario comparisons — tax estimates, loan comparisons, retirement projections, rent vs. buy, investment scenarios, and more. Pure math, no accounts or logins needed.

agencelutie/LP-lutie

Help order groceries for delivery. Concierge-style flow — store selection, occasion-based list building, budget tracking, and cart assembly.

agencelutie/LP-lutie

Help find and book a service provider for a task — cleaning, handyman, moving, assembly, yard work, errands, etc. Searches TaskRabbit, Handy, Thumbtack, and similar platforms.

agencelutie/LP-lutie

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

agencelutie/LP-lutie

Help order food timed to arrive at a specific time. Works backward from target arrival, suggests restaurants, builds cart, and monitors delivery.

agencelutie/LP-lutie

Refill a prescription at a pharmacy. Works from a medication name, an Rx number, a photo of the bottle, or just "I'm running low." Confirms exactly what's being requested, gathers everything the pharmacy will ask for up front, and handles the refill online or by phone — whichever is fastest.

agencelutie/LP-lutie

Help return an item or request a refund from any retailer. Identifies the item, finds the return policy, navigates the process, and handles shipping labels or phone calls.

agencelutie/LP-lutie

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

agencelutie/LP-lutie

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

agencelutie/LP-lutie

Generate structured landing page copy with hero, body, proof, and CTA sections. Framework-agnostic - adapts approach based on awareness level and offer type.

Skills relacionados

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community