D0UGWITHSEISMIC/WITHSEISMIC-MCP
Una plantilla de servidor MCP lista para producción para alojar tus propias herramientas e indicaciones de IA. Implementa de forma remota o ejecuta localmente: diseñada para desarrolladores que desean exponer sus herramientas a modelos de IA sin las complicaciones de la infraestructura.
¿PARA QUIÉN ES ESTO?
Esta plantilla es perfecta para:
Desarrolladores de herramientas de IA : cree y aloje sus propias herramientas con las que los modelos de IA puedan interactuar
Equipos y organizaciones : configure un servidor MCP compartido para sus aplicaciones de IA
Desarrolladores individuales : comience rápidamente su desarrollo de MCP con una configuración lista para producción
Proveedores de API : exponga sus servicios a modelos de IA a través de una interfaz estandarizada
Ya sea que desees:
🌐 Alojar un servidor MCP remoto al que varios clientes puedan conectarse
Ejecutar localmente a través de stdio para desarrollo y pruebas
🚀 Implementar una implementación de MCP lista para producción
🛠️ Crea herramientas sin preocuparte por la infraestructura
Esta plantilla proporciona todo lo que necesitas para comenzar.
://DESCRIPCIÓN GENERAL
El servidor MCP ofrece dos formas de exponer sus herramientas a modelos de IA:
Modo de servidor remoto (SSE) : Implemente como un servidor remoto al que varios clientes pueden conectarse
Perfecto para implementaciones de producción (
pnpm start:sse
)Admite múltiples conexiones simultáneas
Fácil implementación en plataformas como Railway
Seguro y escalable
Modo local (stdio) : se ejecuta localmente para desarrollo y pruebas (
pnpm start
)Ideal para el desarrollo local
Comunicación directa de estudio
Iteración y depuración rápidas
Características principales:
Herramientas : Funciones ejecutables que los modelos pueden llamar
Indicaciones : generadores de mensajes basados en plantillas
Descubrimiento automático : registro automático de sus componentes
Seguridad de tipos : compatibilidad total con TypeScript
://¿POR QUÉ UTILIZAR ESTA PLANTILLA DE SERVIDOR MCP?
Si bien el Protocolo de Contexto de Modelo (MCP) se encuentra en sus etapas iniciales, algo está claro: su rápida adopción requiere un desarrollo sin fricciones . Esta implementación se creó con un enfoque único: permitir que los desarrolladores se concentren en crear herramientas de alta calidad, no infraestructura .
IMPLEMENTACIÓN INSTANTÁNEA
DESARROLLO SIN FRICCIÓN
Sin texto predefinido : define tu herramienta, impórtala y listo. Nosotros nos encargamos del resto.
Registro automático : las herramientas y los mensajes se descubren y registran automáticamente.
Seguridad de tipos : compatibilidad total con TypeScript sin necesidad de configuración.
ARQUITECTURA PROBADA EN BATALLA
Listo para producción : diseñado para brindar confiabilidad y rendimiento.
Diseño escalable : desde herramientas simples hasta interacciones de IA complejas.
Resistente a errores : gestión robusta de errores y depuración integrada.
LA EXPERIENCIA DEL DESARROLLADOR ES PRIMERO
Nos encargamos de:
⚡ Gestión de conexiones
🔄 Registro de herramientas
🛡️ Validación de entrada
📦 Gestión estatal
🚨 Manejo de errores
📊 Registro y métricas
Te centras en:
🎯 Construyendo herramientas increíbles
🧠 Creando indicaciones poderosas
🚀 Características de envío
://EMPEZANDO
INSTALACIÓN
EJECUTANDO EL SERVIDOR
Hay dos modos disponibles:
Modo estándar (stdio):
Modo SSE (eventos enviados por el servidor):
Al ejecutar en modo SSE, conéctese a: http://localhost:3001/sse
://CONCEPTOS_CENTRALES
HERRAMIENTAS
Las herramientas son funciones ejecutables que los modelos pueden invocar. Cada herramienta:
Ha definido esquemas de entrada/salida utilizando Zod
Se registra automáticamente en el registro.
Puede realizar cualquier operación (cálculo, E/S de archivos, llamadas API, etc.)
Herramienta de ejemplo:
INSTRUCCIONES
Las indicaciones son generadores de mensajes que ayudan a estructurar las interacciones del modelo. Cada indicación:
Define su esquema de argumentos
Genera mensajes en un formato consistente
Se registra automáticamente en el registro.
Ejemplo de mensaje:
://AGREGAR_NUEVOS_COMPONENTES
Creando una nueva herramienta
Crea un nuevo archivo en
src/modules/tools/
Define tus esquemas de entrada/salida usando Zod
Crea y exporta tu instancia de herramienta
Agregue la exportación a
src/modules/tools/index.ts
El registro automáticamente:
Registra tu herramienta
Ponerlo a disposición de los modelos
Manejar la validación y el manejo de errores
Crear un nuevo mensaje
Crea un nuevo archivo en
src/modules/prompts/
Define tu esquema de argumentos
Crea y exporta tu instancia de solicitud
Agregue la exportación a
src/modules/prompts/index.ts
El registro automáticamente:
Registra tu mensaje
Ponerlo a disposición de los modelos
Manejar la generación de mensajes y errores
Arquitectura
Componentes principales
Registro : Administrador central de todas las herramientas y avisos
Herramienta : Clase base para funciones ejecutables
Indicación : Clase base para generadores de mensajes
Servidor : Implementación del protocolo MCP
Registro automático
El sistema utiliza un patrón de Registro singleton que:
Registra automáticamente las herramientas y las indicaciones al importar
Proporciona acceso seguro a los componentes
Maneja todas las interacciones del protocolo MCP
Manejo de errores
El sistema incluye un manejo robusto de errores:
Validación de tipos mediante esquemas Zod
Envoltura de errores de ejecución
Mensajes de error detallados para depuración
Desarrollo
Seguridad de tipos
Todos los componentes utilizan TypeScript para una seguridad de tipos completa:
Los esquemas de entrada/salida se definen utilizando Zod
Inferencia de tipos para argumentos y resultados de herramientas
Tipos de errores completos
Pruebas
Ejecutar pruebas usando:
Mejores prácticas
Defina siempre esquemas de entrada/salida claros
Utilice nombres descriptivos y documentación
Manejar los errores con elegancia
Siga las pautas de TypeScript en el código base
://CONTRIBUYENDO
¡Agradecemos sus contribuciones! Consulte nuestra Guía de Contribución para obtener más información sobre:
Flujo de trabajo de desarrollo
Pautas de estilo de código
Proceso de solicitud de extracción
Informe de problemas
¡Únete a nuestra comunidad de Discord para conectarte con otros colaboradores!
://APOYO
📫 Correo electrónico: hello@withseismic.com
💬 Discord: Únete a nuestro servidor
://LICENCIA
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
© 2025 Doug, en WithSeismic punto com.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Una implementación de TypeScript de un servidor de Protocolo de Contexto de Modelo que brinda un marco sin fricciones para que los desarrolladores creen e implementen herramientas y avisos de IA, centrándose en la experiencia del desarrollador con cero código repetitivo y registro automático de herramientas.
- ¿PARA QUIÉN ES ESTO?
- ://DESCRIPCIÓN GENERAL
- ://¿POR QUÉ UTILIZAR ESTA PLANTILLA DE SERVIDOR MCP?
- ://EMPEZANDO
- ://CONCEPTOS_CENTRALES
- ://AGREGAR_NUEVOS_COMPONENTES
- Arquitectura
- Desarrollo
- ://CONTRIBUYENDO
- ://APOYO
- ://LICENCIA
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol implementation for managing and serving AI prompts with a TypeScript-based architecture in a monorepo structure.Last updated -30,046,54415
- AsecurityAlicenseAqualityA TypeScript-based Model Context Protocol toolkit that enables AI to interact with code files, manage translations, build projects, and search for files and code content.Last updated -3305MIT License
- -securityFlicense-qualityA TypeScript-based starter template for building Model Context Protocol servers that enables AI assistants to dynamically call tools, interpret prompts, and manage resources through modular architecture with support for multiple transport methods.
- -securityFlicense-qualityA foundation for developing custom Model Context Protocol servers in TypeScript that connects AI assistants with external APIs and data sources using a complete layered architecture pattern.Last updated -124