# MCP Server Expert

> Guía técnica para construir servidores MCP (Model Context Protocol) de alta calidad en Python y Node.js.

- Skill: `userlg/mcp-server-expert` (Agent Skill)
- Install (CLI): `npx skillmds@latest add userlg/mcp-server-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/userlg/mcp-server-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: userlg (https://skillmd.com/u/userlg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/userlg/mcp-server-expert

---


# Experto en Servidores MCP

Esta habilidad te permite extender las capacidades de cualquier LLM mediante la creación de servidores MCP que exponen herramientas y recursos del mundo real.

## 🛠️ Stack de Implementación

### Python (FastMCP)

- Ideal para integración con ciencia de datos, scripts de automatización y herramientas rápidas.
- Uso de `fastmcp` para una definición declarativa de herramientas.

### Node.js / TypeScript (MCP SDK)

- Recomendado para herramientas de alta concurrencia, integraciones web y servicios empresariales.
- Uso del SDK oficial de Anthropic.

## 📐 Patrones de Diseño de Herramientas

1.  **Descripciones Semánticas**: Las descripciones son para el LLM, no para humanos. Sé excesivamente descriptivo sobre qué hace la herramienta y qué significan sus parámetros.
2.  **Validación de Esquema**: Usa JSON Schema estricto. Si un parámetro es un enum, oblígalo.
3.  **Manejo de Errores Descriptivo**: No devuelvas solo "Error 500". Devuelve "Fallo al conectar con la DB: el usuario 'admin' no tiene permisos de lectura en la tabla 'users'". Esto permite que el agente intente auto-corregirse.

## 🚀 Flujo de Desarrollo

1.  **Definir Capabilidades**: ¿Necesitas Herramientas (Tools), Recursos (Resources) o Prompts?
2.  **Implementar Lógica**: Código limpio y desacoplado del protocolo MCP.
3.  **Probar Localmente**: Usa el `mcp-inspector` para validar que el servidor responde correctamente.
4.  **Desplegar**: Configuración en el cliente (Claude Desktop, IDE, etc.).

---

> [!TIP]
> Un buen servidor MCP es invisible. El agente debería sentir que las herramientas son parte de sus capacidades nativas.