MCP POC

Un servidor MCP (Model Context Protocol) desarrollado en Node.js/TypeScript con arquitectura modular que es compatible con Claude Desktop.

ElModel Context Protocol (MCP)es un protocolo abierto desarrollado por Anthropic que permite a los modelos de IA interactuar de forma segura con herramientas y fuentes de datos externas. Piensa en MCP como el "USB-C" de las integraciones de IA: un estándar único que conecta muchos servicios.

- Servidores MCP: Actúan como puentes hacia APIs, bases de datos o código
- Clientes MCP: Utilizan el protocolo para interactuar con los servidores
- Hosts MCP: Sistemas que gestionan la comunicación (como Claude Desktop)

Este servidor MCP incluye tres herramientas de ejemplo:
- greeting- Genera saludos personalizados en español (formal/informal)
- calculator- Realiza operaciones matemáticas básicas (suma, resta, multiplicación, división)
- get_current_datetime- Obtiene la fecha y hora actual en diferentes formatos

# Instalar globalmente npm install -g @sokardys/mcp-poc # O usar npx (sin instalación) npx sokardys-mcp-poc

git clone <tu-repositorio> cd mcp-poc npm install npm run build

Edita el archivo de configuración de Claude Desktop:

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "mcp-poc": { "command": "npx", "args": ["@sokardys/mcp-poc@latest"], "env": { } } } }

{ "mcpServers": { "mcp-poc": { "command": "node", "args": [ "/ruta/completa/a/tu/proyecto/mcp-poc/build/index.js" ] } } }

Importante: Para desarrollo local, cambia/ruta/completa/a/tu/proyecto/mcp-poc/por la ruta real donde clonaste el proyecto.

Cierra y vuelve a abrir Claude Desktop para cargar la nueva configuración.

Una vez configurado, puedes usar las herramientas en Claude Desktop:

- Saludo: "Saluda a María de forma formal" → Usagreeting
- Cálculo: "Calcula 15 × 8" → Usacalculator
- Fecha: "¿Qué hora es?" → Usaget_current_datetime

# Compilar el proyecto npm run build # Modo desarrollo (recompilación automática) npm run dev # Ejecutar directamente (después de compilar) npm start # Inspeccionar el servidor MCP npm run inspector # Testing npm test # Ejecutar todos los tests npm run test:watch # Tests en modo watch npm run test:ui # Interfaz visual de tests npm run test:coverage # Tests con cobertura de código

Este proyecto incluye un suite completo de tests usandoVitestymcpgod:

# Tests básicos npm test # Tests en modo watch (reejecutar al cambiar código) npm run test:watch # Interfaz visual para tests npm run test:ui # Tests con reporte de cobertura npm run test:coverage

✅Lista de herramientas- Verifica que todas las herramientas están disponibles ✅Herramienta greeting- Formatos formal e informal, nombres personalizados ✅Calculadora- Suma, resta, multiplicación, división con validación Zod ✅Manejo de errores- División por cero, parámetros faltantes, McpError apropiados ✅Fecha y hora- Diferentes formatos (corto, largo, ISO), zonas horarias ✅Validación de entrada- Schemas Zod, tipos incorrectos, parámetros requeridos ✅Arquitectura modular- Separación resolver/usecase, orquestador central

# Listar herramientas disponibles npx mcpgod tools build/index.js # Probar herramientas específicas npx mcpgod tool build/index.js greeting name="Ana" formal=true npx mcpgod tool build/index.js calculator operation="add" a=15 b=25 npx mcpgod tool build/index.js get_current_datetime format="long"

- Documentación oficial de MCP
- Servidor de referencia de Anthropic
- SDK de TypeScript
- Vitest - Framework de testing
- mcpgod - CLI para MCP

Instead of direct calling MCP tools, mcpcode server transforms MCP tool calls into TypeScript programs, enabling smarter, lower-latency orchestration by LLMs.