D0UGWITHSEISMIC/WITHSEISMIC-MCP

SYSTEMS ONLINE • NEURAL INTERFACE ACTIVE • COMBAT DATA ANALYSIS • TACTICAL OVERLAY ENABLED • PERFORMANCE METRICS NOMINAL

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

# Option 1: One-Click Deploy
Click the "Deploy on Railway" button above ☝️

# Option 2: Local Setup
pnpm install && pnpm dev

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

// That's it. This is all you need to create a tool.
export const myTool = new Tool(
  {
    name: "myTool",
    description: "What my tool does",
    inputSchema: z.object({ query: z.string() }),
    outputSchema: z.object({ result: z.string() }),
  },
  async (args) => {
    // Your logic here
    return { result: "Done!" };
  },
);

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

pnpm install

EJECUTANDO EL SERVIDOR

Hay dos modos disponibles:

Modo estándar (stdio):

pnpm dev      # Development with hot reload
pnpm start    # Production

Modo SSE (eventos enviados por el servidor):

pnpm dev:sse  # Development with hot reload
pnpm start:sse # Production

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:

import { z } from "zod";
import { Tool } from "../core";

const MyToolInputSchema = z.object({
  param1: z.string().describe("Parameter description"),
});

const MyToolOutputSchema = z.object({
  result: z.string().describe("Result description"),
});

export const myTool = new Tool(
  {
    name: "myTool",
    description: "What my tool does",
    inputSchema: MyToolInputSchema,
    outputSchema: MyToolOutputSchema,
  },
  async (args) => {
    const input = MyToolInputSchema.parse(args);
    // Tool logic here
    return { result: "processed result" };
  },
);

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:

import { Prompt } from "../core";

export const myPrompt = new Prompt(
  {
    name: "myPrompt",
    description: "What my prompt does",
    arguments: [
      {
        name: "arg1",
        description: "Argument description",
        required: true,
      },
    ],
  },
  async (args) => {
    return [
      {
        role: "system",
        content: {
          type: "text",
          text: `Generated message using ${args.arg1}`,
        },
      },
    ];
  },
);

://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:

pnpm test

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

NEURAL INTERFACE DETECTED • INITIATING COLLABORATION PROTOCOLS • READY FOR UPLINK

¡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

SUPPORT PROTOCOLS ACTIVE • COMMUNICATION CHANNELS OPEN • READY TO ASSIST

📫 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.

WithSeismic MCP

Integrations