mcp-tutorial-ts

# 🚀 Tutorial de MCP con TypeScript <div align="center"> <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript" /> <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js" /> <img src="https://img.shields.io/badge/Model%20Context%20Protocol-FF6B6B?style=for-the-badge" alt="MCP" /> </div> Bienvenido al tutorial práctico para implementar un servidor MCP (Model Context Protocol) con TypeScript. Este proyecto te mostrará cómo crear tu propio servidor MCP con herramientas personalizadas que pueden ser utilizadas por LLMs como ChatGPT a través de clientes como Windsurf o Cursor. ## 📺 Video Tutorial Puedes ver el video completo de este tutorial en YouTube: [](https://www.youtube.com/watch?v=3zieSW8Ryvg) ## 📋 Contenido del Tutorial 1. **Introducción a MCP** - ¿Qué es el Model Context Protocol? - Arquitectura Cliente-Servidor - Casos de uso y ejemplos prácticos 2. **Ejemplos Implementados** - Calculadora de días entre fechas - Búsqueda de personajes de Disney - Recursos personalizados - Plantillas de prompts 3. **Integración con Herramientas** - Configuración con Windsurf - Uso con MCP Inspector - Pruebas de herramientas ## 🛠️ Requisitos Previos - Node.js 18+ (recomendado) - Bun o npm/yarn - Conocimientos básicos de TypeScript - [Opcional] TSX para ejecutar TypeScript directamente ## 🚀 Instalación y Uso 1. **Clona el repositorio** ```bash git clone https://github.com/imzodev/mcp-tutorial-ts.git cd mcp-tutorial-ts ``` 2. **Instala las dependencias** ```bash # Con Bun (recomendado) bun install # O con npm npm install ``` 3. **Ejecuta el servidor MCP** ```bash # Con Bun bun run dev # O con npm npm run dev ``` 4. **Prueba con MCP Inspector** ```bash npx @modelcontextprotocol/inspector@latest --command "tsx src/server.ts" ``` ## 🔧 Herramientas Implementadas 1. **Cálculo de días entre fechas** - Utiliza date-fns para cálculos de fechas - Parámetros: fechaInicio, fechaFin 2. **Búsqueda de personajes de Disney** - Integración con la API pública de Disney - Devuelve información detallada de personajes ## 📚 Recursos Adicionales - [Documentación Oficial de MCP](https://modelcontextprotocol.io/) - [Repositorio de MCP en GitHub](https://github.com/modelcontextprotocol) - [Ejemplos de MCP Servers](https://github.com/modelcontextprotocol/servers) ## 🤝 Cómo Contribuir 1. Haz un fork del repositorio 2. Crea una rama para tu característica (`git checkout -b feature/nueva-caracteristica`) 3. Haz commit de tus cambios (`git commit -am 'Añade nueva característica'`) 4. Haz push a la rama (`git push origin feature/nueva-caracteristica`) 5. Abre un Pull Request ## 📄 Licencia Este proyecto está bajo la Licencia MIT. Ver el archivo [LICENSE](LICENSE) para más detalles. --- <div align="center"> Tutorial creado por <a href="https://github.com/imzodev">ImzoDev</a> para la comunidad de desarrollo </div>