Communitygithub.com

aiskillstore/marketplace

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

¿Qué es marketplace?

La habilidad 'aiskillstore/marketplace' es una guía completa para desarrolladores que desean crear servidores MCP (Model Context Protocol) de alta calidad. Su objetivo principal es enseñar cómo diseñar servidores MCP que permitan a los modelos de lenguaje grandes (LLMs) interactuar con servicios externos de manera eficiente a través de herramientas bien estructuradas. La guía cubre todo el proceso, desde la planificación inicial hasta la implementación, pruebas y evaluación, proporcionando referencias detalladas para los SDK de Python y TypeScript. Es especialmente útil porque no solo explica la teoría, sino que ofrece ejemplos prácticos, listas de verificación y plantillas para proyectos, lo que facilita la creación de servidores robustos y mantenibles. Además, hace hincapié en la importancia del diseño de herramientas con nombres descriptivos, esquemas de entrada y salida claros, y mensajes de error accionables. La habilidad está diseñada para ser utilizada con asistentes de IA como Claude Code, Cursor o Codex, y se integra perfectamente con el ecosistema MCP, soportando transportes como HTTP y stdio. Al seguir esta guía, los desarrolladores pueden crear servidores que se integren con cualquier API externa, asegurando que los LLMs puedan realizar tareas complejas de manera autónoma y fiable.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiskillstore/marketplace/tree/HEAD/skills/mcp-builder

Preguntar en tu IA favorita

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

Documentación

Guía de Desarrollo de Servidores MCP

Resumen

Crea servidores MCP (Model Context Protocol) que permitan a los LLMs interactuar con servicios externos a través de herramientas bien diseñadas. La calidad de un servidor MCP se mide por lo bien que permite a los LLMs 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 MCP Moderno

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.

Nomenclatura y Descubrimiento 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 de herramientas concisas 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 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 de 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 amplio uso, 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.

Carga la documentación del framework:

Para TypeScript (recomendado):

  • SDK 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 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 de 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
  • Añade ejemplos en las descripciones de los campos

Esquema de Salida:

  • Define outputSchema siempre que sea posible para datos estructurados
  • Usa structuredContent en las respuestas de las herramientas (característica del SDK TypeScript)
  • Ayuda a los clientes a entender 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 de errores adecuado con mensajes accionables
  • Soporte de paginación donde corresponda
  • 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 lo siguiente:

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

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 tu_servidor.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 completas para probar su efectividad.

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

4.1 Comprender el Propósito de la Evaluación

Usa las evaluaciones para probar si los LLMs pueden usar tu servidor MCP de manera efectiva para responder preguntas realistas y complejas.

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 importarían a los humanos
  • Verificable: Una única respuesta clara que se pueda verificar 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 con 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 - Directrices universales de MCP que incluyen:
    • Convenciones de nomenclatura de servidores y herramientas
    • Directrices 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 Python: Obtener de https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md
  • SDK TypeScript: Obtener 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 con:

    • Patrones de inicialización de servidores
    • 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 con:

    • 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 con:
    • Directrices de 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.

aiskillstore/marketplace

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

aiskillstore/marketplace

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

aiskillstore/marketplace

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

aiskillstore/marketplace

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

aiskillstore/marketplace

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

aiskillstore/marketplace

This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates. Agent should proactively apply this skill when users express needs like search for GitHub projects by keywords, find top open-source contributors in specific domains, extract developer contacts from GitHub repositories, discover trending repositories with high stars, gather contributor profiles and social links for tech recruiting, retrieve GitHub project descriptions and metrics, build developer communities by finding active contributors, search for repositories updated recently, collect personal website and Twitter links of developers, generate targeted leads for developer tools, or track active open-source contributors for collaboration.

aiskillstore/marketplace

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.

aiskillstore/marketplace

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

aiskillstore/marketplace

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

aiskillstore/marketplace

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

aiskillstore/marketplace

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

aiskillstore/marketplace

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

aiskillstore/marketplace

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.).

aiskillstore/marketplace

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

aiskillstore/marketplace

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

aiskillstore/marketplace

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

aiskillstore/marketplace

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

aiskillstore/marketplace

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

aiskillstore/marketplace

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

aiskillstore/marketplace

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

Skills relacionados