Servidor MCP de TypeScript Prompt

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona plantillas de indicaciones predefinidas para asistentes de IA, lo que les permite generar planes integrales para proyectos TypeScript, arquitecturas de API y flujos de trabajo de GitHub.

🌟 Descripción general

Este servidor MCP proporciona un conjunto de plantillas de indicaciones que los asistentes de IA pueden usar para generar respuestas detalladas y estructuradas para la planificación de proyectos de TypeScript. Ofrece plantillas para:

• Creación de planes integrales de arquitectura de API

• Configuración de nuevos proyectos TypeScript con las mejores prácticas

• Generar configuraciones de flujo de trabajo de GitHub

Este MCP se creó específicamente para funcionar con el MCP de desarrollo local, creando una potente combinación donde el MCP de aviso genera planes de proyecto detallados y el MCP de desarrollo local los ejecuta. Juntos, crean un flujo de trabajo fluido para el desarrollo de proyectos de TypeScript asistido por IA.

Cada plantilla de solicitud está diseñada para garantizar que los asistentes de IA proporcionen planes de proyecto consistentes, detallados y de alta calidad siguiendo los estándares de desarrollo modernos de TypeScript.

🚀 Características

• 🏗️ Planificación de la arquitectura de API : genere planes de arquitectura de API integrales que incluyan capas, estructuras de carpetas y esquemas de bases de datos

• 🚀 Configuración del proyecto : cree planes de configuración detallados para nuevos proyectos de TypeScript con dependencias y configuraciones adecuadas

• 🔄 Flujo de trabajo de GitHub : Diseñe planes de flujo de trabajo de GitHub con estrategias de rama, plantillas de PR y configuraciones de CI/CD

• 🛠️ Personalización : cada solicitud acepta parámetros para adaptar los planes generados a sus necesidades específicas.

• ⚡ Salida consistente : garantiza que los asistentes de IA brinden respuestas estructuradas y detalladas que sigan las mejores prácticas

📋 Requisitos previos

• Node.js (v14 o superior)

• npm o hilo

🔧Instalación

1. Clonar el repositorio

   git clone <repository-url> cd typescript-prompt-mcp

2. Instalar dependencias

   npm install

3. Configurar variables de entorno

   # Create development environment file cp .env.example .env.development # Create production environment file cp .env.example .env.production

🎮 Uso

Modo de desarrollo

Esto inicia el servidor MCP en modo de desarrollo con recarga en caliente.

Modo de producción

O utilice la abreviatura:

🔗 Integración con Local Dev MCP y Claude Desktop

Para agregar este servidor MCP a Claude Desktop:

1. Inicie el servidor MCP Asegúrese de que su servidor esté ejecutándose localmente.

2. Abrir la configuración de Claude Desktop

   • Iniciar Claude Desktop

   • Haz clic en tu foto de perfil o en el icono en la parte superior derecha.

   • Seleccione "Configuración" en el menú desplegable.

3. Vaya a la configuración de extensiones

   • En la barra lateral de Configuración, haga clic en "Extensiones".

   • Seleccione "Agregar MCP personalizado"

4.1 Configurar la conexión MCP

• Nombre: TypeScript Prompt MCP (o cualquier nombre que prefieras)

• URL: Ingrese la URL donde se ejecuta su servidor MCP (por ejemplo, http://localhost:3000 para desarrollo local)

• Haga clic en "Agregar MCP"

4.2 Alternativa: Configurar la conexión MCP mediante comando

• Primero debe compilar el proyecto y proporcionar su ruta completa al servidor compilado

• Agregue lo siguiente a su configuración de Claude Desktop:

5. Habilitar el MCP

   • Mueva el interruptor junto al MCP recién agregado para habilitarlo

   • Claude Desktop intentará conectarse a su servidor MCP

6. Agregar MCP de desarrollo local

   • Repita los pasos 3 a 5 para agregar también el MCP de desarrollo local a Claude Desktop

   • Tener ambos MCP habilitados permite un flujo de trabajo completo desde la planificación hasta la implementación

7. Verificar la conexión

   • Inicia una nueva conversación con Claude

   • Pídale a Claude que le ayude a planificar un proyecto de TypeScript o una arquitectura de API

   • Claude ahora debería poder usar las plantillas de indicaciones para proporcionar planes detallados.

   • Luego pídale a Claude que implemente el plan usando Local Dev MCP

Ejemplos de uso con Claude

Una vez conectado con ambos MCP, puedes pedirle a Claude que:

• "¿Puedes ayudarme a planificar una arquitectura de API para un proyecto de TypeScript llamado 'backend de comercio electrónico' con MongoDB y autenticación JWT?" (usa este MCP de Prompt)

• "Necesito un plan de configuración para una nueva biblioteca de interfaz TypeScript con componentes React" (usa este MCP de Prompt)

• "Crear un plan de flujo de trabajo de GitHub para mi proyecto TypeScript CLI con pruebas automatizadas y publicación npm" (usa este MCP de Prompt)

• "Ahora implemente el proyecto de API que acabamos de planificar utilizando Local Dev MCP" (usa Local Dev MCP)

• "Configurar el proyecto TypeScript con el plan que creamos" (usa Local Dev MCP)

Esta combinación de MCP crea un flujo de trabajo poderoso donde puedes planificar tu proyecto en detalle y luego implementarlo sin salir de la interfaz de Claude.

🧠 Indicaciones disponibles

El servidor expone varias indicaciones que pueden ser utilizadas por los asistentes de IA:

api-architecture

Genera un plan de arquitectura integral para una API de TypeScript.

Parámetros:

• projectName : Nombre del proyecto API

• database : Base de datos a utilizar (postgres, mysql, mongodb, etc.)

• auth : método de autenticación (jwt, oauth, ninguno)

• endpoints : lista separada por comas de los principales puntos finales de la API

new-project-setup

Genera un plan de configuración completo para un nuevo proyecto de TypeScript.

Parámetros:

• projectName : Nombre del proyecto

• projectType : Tipo de proyecto (api, frontend, biblioteca, cli)

• features : Características o requisitos clave separados por comas

github-workflow

Genera un plan de flujo de trabajo de GitHub para un proyecto TypeScript.

Parámetros:

• projectName : Nombre del proyecto

• ciFeatures : lista separada por comas de características de CI (lint, prueba, compilación, etc.)

• deployTarget : Destino de implementación (netlify, vercel, aws, azure, etc.)

• branchStrategy : Estrategia de rama (gitflow, trunk, github-flow)

🔍 Cómo funciona

El servidor crea un servidor MCP utilizando el SDK ModelContextProtocol:

1. Define indicaciones estructuradas con parámetros que utilizan zod para la validación.

2. Cada mensaje devuelve un mensaje formateado que guía a los asistentes de IA en la generación de planes integrales.

3. Las indicaciones incluyen instrucciones detalladas sobre qué incluir en los planes.

4. El servidor se conecta a Claude u otros asistentes de IA compatibles con MCP a través de un transporte (normalmente stdio)

🛠️ Estructura del proyecto

⚙️ Desarrollo

Agregar nuevos avisos

Para agregar una nueva plantilla de mensaje:

1. Crea un nuevo archivo en el directorio src/prompts

2. Define tu mensaje usando el método mcpServer.prompt()

3. Agregar validación de parámetros mediante esquemas zod

4. Exporte su mensaje en src/prompts/index.ts

Ejemplo:

Configuración del entorno

El servidor utiliza diferentes archivos de entorno para el desarrollo y la producción:

• .env.development : se utiliza cuando se ejecuta en modo de desarrollo

• .env.production : se utiliza cuando se ejecuta en modo de producción

Pruebas

Ejecute el conjunto de pruebas con:

Pelusa y formato

📝 Notas para la implementación

Al implementar en producción:

1. Asegúrese de que su archivo .env.production contenga credenciales válidas si es necesario

2. El proceso de compilación integrará estas credenciales en el código compilado

3. Utilice npm run prod para compilar e iniciar el servidor de producción

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Autor

Gpaul | Faldin