Integración de servidor MCP — Ejercicio de construcción

Andamiaje para el ejercicio de preparación de CCA-F de 2.4 Integración de servidor MCP. Nada está resuelto aquí — cada tarea a continuación tiene un TODO para que lo completes.

Lista de tareas

• 1. Configuración a nivel de proyecto — .mcp.json tiene una entrada de servidor github (command/args). Cámbiala por el servidor comunitario que prefieras, si no es GitHub.

• 2. Expansión de variables de entorno — la entrada github hace referencia a ${GITHUB_TOKEN} en lugar de una credencial codificada. Copia .env.example a .env y completa con un token real.

• 3. Configuración a nivel de usuario — no se crea aquí a propósito, ya que ~/.claude.json vive fuera del proyecto y es personal de tu máquina. Plantilla y pasos: docs/user-level-config.md.

• 4. Exponer un recurso MCP — src/server.ts tiene un recurso catalogue://TODO de marcador de posición. Reemplázalo con un catálogo de contenido real (por ejemplo, un esquema de base de datos o una jerarquía de documentación) con un URI, nombre, descripción y mimeType adecuados.

• 5. Mejorar las descripciones de herramientas — en el mismo archivo, example_tool tiene una descripción de marcador de posición. Escribe de 3 a 5 oraciones que cubran capacidad, salida, caso de uso y cómo se compara con una alternativa integrada.

Related MCP server: MCP Inspector Server

Configuración

npm install
npm run dev        # starts the stdio server directly
npm run inspect     # opens MCP Inspector against the server for manual testing

Estructura

.mcp.json                   Task 1 & 2 — project-level server config
.env.example                Task 2 — template for the secret .mcp.json expands
docs/user-level-config.md   Task 3 — template + steps for ~/.claude.json
src/server.ts                Task 4 & 5 — custom MCP server with resource/tool stubs