Con MCP Sísmico

D0UGWITHSEISMIC/WITHSEISMIC-MCP

Con MCP Sísmico

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Starter
StevenStavrakis
A
security
A
license
A
quality
A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.
Last updated -
1
1
12
JavaScript
MIT License
MCP Framework
ronangrant
-
security
F
license
-
quality
A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
Last updated -
67
TypeScript
GonMCPtool
GonTwVn
A
security
A
license
A
quality
A 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 -
33
43
5
TypeScript
MIT License
MCP Server TypeScript Template
minimind-org
-
security
F
license
-
quality
A TypeScript template for creating Model Context Protocol servers that enable AI models to utilize external tools, including example operations and simple number addition functionality.
Last updated -
2
TypeScript

View all related MCP servers

WithSeismic MCP