🚀 Mi MCP Server
Un servidor del Model Context Protocol (MCP) construido con TypeScript que se conecta con cualquier cliente MCP como Claude, VS Code, Cursor y más
📋 Tabla de Contenidos
- ✨ Características
- 🛠️ Herramientas Disponibles
- 📦 Requisitos Previos
- 🚀 Instalación
- 🔧 Configuración para Clientes
- VS Code
- Cursor
- Claude Desktop
- 🧪 Uso y Pruebas
- 📁 Estructura del Proyecto
- 🤝 Contribución
- 📄 Licencia
✨ Características
- ✅ Herramientas (Tools): Funciones que la IA puede ejecutar
- ✅ Recursos (Resources): Datos estructurados que la IA puede leer
- ✅ Prompts: Plantillas de instrucciones reutilizables
- ✅ Compatible con múltiples clientes: VS Code, Claude Desktop, Cursor y más
- ✅ TypeScript: Código tipado y moderno
- ✅ Fácil de extender: Añade tus propias herramientas en minutos
🛠️ Herramientas Disponibles
| Herramienta | Descripción | Ejemplo |
|---|---|---|
echo |
Devuelve el mensaje que recibe | echo("Hola mundo") → "Echo: Hola mundo" |
sum |
Suma dos números | sum(5, 3) → "5 + 3 = 8" |
get_current_time |
Muestra la hora actual | get_current_time() → "Hora: 14:30:45" |
greeting (Resource) |
Saludo personalizado | greeting://Juan → "Hello, Juan!" |
summarize (Prompt) |
Plantilla para resumir texto | Pide resumir cualquier texto |
📦 Requisitos Previos
🚀 Instalación
1. Clonar el repositorio
git clone https://github.com/tu-usuario/mcp-server.git
cd mcp-server
2. Instalar Dependencias
pnpm install
3. Compilar el proyecto
pnpm run build
4. Ejecutar el servidor
pnpm start
Configuración para Clientes
- Crea el archivo .vscode/mcp.json con el siguiente contenido:
{
"servers": {
"mi-servidor": {
"command": "node",
"args": ["dist/index.js"]
}
}
}
- Abre VS Code en la carpeta del proyecto
- Asegúrate de tener la extensión GitHub Copilot instalada
- En Copilot Chat, ya puedes usar las herramientas del servidor
Estructura del Proyecto
mcp-server/
├── .vscode/
│ └── mcp.json # Configuración para VS Code
├── dist/ # Código compilado
├── src/
│ └── index.ts # Código fuente del servidor
├── scripts/
│ └── install-desktop.js # Script para Claude Desktop
├── package.json # Dependencias y scripts
├── tsconfig.json # Configuración TypeScript
└── README.md # Este archivo
Licencia
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.
Agradecimientos
Model Context Protocol - El protocolo que hace esto posible
Anthropic - Por Claude y el soporte a MCP
Comunidad de desarrolladores MCP