hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides templates for designing GitHub workflow plans including branch strategies, PR templates, and CI/CD configurations
Supports generating API architecture plans with MongoDB integration as a database option
Supports generating API architecture plans with MySQL integration as a database option

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

Clonar el repositorio
git clone <repository-url> cd typescript-prompt-mcp
Instalar dependencias
npm install
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

npm run dev

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

Modo de producción

npm run build
npm start

O utilice la abreviatura:

npm run prod

🔗 Integración con Local Dev MCP y Claude Desktop

Para agregar este servidor MCP a Claude Desktop:

Inicie el servidor MCP Asegúrese de que su servidor esté ejecutándose localmente.
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.
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:

"ts-prompts": {
  "command": "node",
  "args": [
    "YOUR_CUSTOM_PATH/dist/index.js"
  ]
}

Habilitar el MCP
- Mueva el interruptor junto al MCP recién agregado para habilitarlo
- Claude Desktop intentará conectarse a su servidor MCP
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
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:

Define indicaciones estructuradas con parámetros que utilizan zod para la validación.
Cada mensaje devuelve un mensaje formateado que guía a los asistentes de IA en la generación de planes integrales.
Las indicaciones incluyen instrucciones detalladas sobre qué incluir en los planes.
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

src/
  ├── index.ts                # Entry point that sets up the MCP server
  ├── prompts/                # Prompt definitions
  │   ├── apiArchitecture.ts  # API architecture prompt
  │   ├── githubWorkflow.ts   # GitHub workflow prompt
  │   ├── newProjectSetup.ts  # New project setup prompt
  │   └── index.ts            # Exports all prompts
scripts/
  ├── prepare-build.ts        # Script for preparing production builds
  ├── run-relevant-tests.ts   # Script for running tests on changed files
  └── setup-husky.js          # Script for setting up Git hooks

⚙️ Desarrollo

Agregar nuevos avisos

Para agregar una nueva plantilla de mensaje:

Crea un nuevo archivo en el directorio src/prompts
Define tu mensaje usando el método mcpServer.prompt()
Agregar validación de parámetros mediante esquemas zod
Exporte su mensaje en src/prompts/index.ts

Ejemplo:

import { z } from 'zod';
import { mcpServer } from '../index';

mcpServer.prompt(
  'my-new-prompt',
  'Description of what this prompt does',
  {
    param1: z.string().describe('Description of param1'),
    param2: z.number().optional().describe('Description of param2'),
  },
  async ({ param1, param2 = 0 }) => {
    return {
      messages: [
        {
          role: 'user',
          content: {
            type: 'text',
            text: `Your prompt template with ${param1} and ${param2}...`,
          },
        },
      ],
    };
  },
);

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:

npm test

Pelusa y formato

# Run ESLint
npm run lint

# Fix ESLint errors
npm run lint:fix

# Format code with Prettier
npm run format

# Check formatting
npm run format:check

📝 Notas para la implementación

Al implementar en producción:

Asegúrese de que su archivo .env.production contenga credenciales válidas si es necesario
El proceso de compilación integrará estas credenciales en el código compilado
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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Proporciona plantillas de indicaciones predefinidas para que los asistentes de IA generen planes integrales para proyectos TypeScript, arquitecturas de API y flujos de trabajo de GitHub.

Appeared in Searches

Developing a System Using TypeScript