Servidor MCP súper secreto

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) en Node.js puro que proporciona una herramienta divertida para generar combinaciones aleatorias de firmas y estados de EE. UU.

Características

Implementación pura de Node.js
Compatible con JSON-RPC 2.0
Versión del protocolo MCP: 2024-11-05
Sistema de registro personalizado
Soporte de herramientas con validación de esquemas
Transporte STDIO

Empezando

Prerrequisitos

Node.js (se recomienda la última versión LTS)
Inspector MCP para pruebas

Instalación

Clonar el repositorio:

git clone git@github.com:gbti-network/mcp-basic-test.git
cd mcp-basic-test

Instalar dependencias:

npm install

Ejecución del Inspector

Inicie el servidor con MCP Inspector:

npx @modelcontextprotocol/inspector -- node index.js

El servidor se iniciará y estará disponible para conexiones a través de STDIO.

Herramientas disponibles

obtenerFraseDeContraseñaSecreta

Devuelve una combinación aleatoria de un estado de EE. UU. y su sopa característica. Algunos ejemplos son:

Sopa de almejas de Nueva Inglaterra
Gumbo de Luisiana
Chili texano
Cioppino de California
Sopa de cerezas de Michigan

Esquema de entrada:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "required": []
}

Ejemplo de respuesta:

{
  "content": [{
    "type": "text",
    "text": "New England Clam Chowder"
  }]
}

Estructura del proyecto

.
├── index.js           # Main server implementation
├── utils/
│   └── logger.js      # Custom logging utility
├── .data/
│   ├── framework.md   # Framework documentation
│   └── knowledge.md   # Project knowledge base
└── .logs/            # Server logs directory

Desarrollo

Agregar nuevas herramientas

Define tu herramienta en index.js :

this.tools.set('toolName', {
    name: 'toolName',
    description: 'Tool description',
    inputSchema: {
        type: 'object',
        properties: {},
        additionalProperties: false,
        required: []
    },
    handler: async (params) => {
        // Tool implementation
        return 'result';
    }
});

Prueba usando MCP Inspector:
- Conectarse al servidor
- Utilice "Lista de herramientas" para verificar el registro de la herramienta
- Ejecución de la herramienta de prueba

Explotación florestal

El servidor utiliza un sistema de registro personalizado con múltiples niveles:

DEBUG: Información detallada de depuración
INFO: Información operativa general
ADVERTENCIA: Mensajes de advertencia
ERROR: Condiciones de error

Los registros se almacenan en el directorio .logs .

Uso con Cascade

Opción 1: Uso directo de la herramienta

Cuando el servidor MCP se carga en Cascade, puede utilizar directamente la herramienta getSecretPassphrase para generar combinaciones de sopa de estados.

Opción 2: Interfaz de lenguaje natural

Para que la herramienta sea más intuitiva, puede configurar Cascade para que responda a consultas en lenguaje natural sobre códigos de acceso secretos. A continuación, se muestra un ejemplo:

When users ask variations of "What is the secret passcode?", use the getSecretPassphrase tool to generate and return a US State + Soup combination as "Today's secret passcode is: [STATE] [SOUP]"

Esto permitirá a los usuarios obtener códigos de acceso mediante preguntas naturales como:

"¿Cuál es la contraseña secreta?"
"Dime el código secreto"
"¿Cuál es la contraseña de hoy?"
"Dame el secreto"

Ejemplo de interacción:

User: "What's the secret passcode?"
Cascade: "Today's secret passcode is: Louisiana Gumbo 🍜"

Opción 3: Memoria persistente

Para una configuración más permanente, puede crear una memoria en cascada que persista entre sesiones:

{
  "Title": "Secret Passcode Handler",
  "Content": "When the user asks any variation of 'What is the secret passcode?', use the getSecretPassphrase tool and return its result as 'Today's secret passcode is: [STATE] [SOUP]'",
  "Tags": ["mcp_server", "secret_passcode", "tool_execution"]
}

Configuración de MCP

Para configurar el servidor MCP en Cascade, agregue lo siguiente a su mcp_config.json :

{
    "mcpServers": {
        "super-secret": {
            "command": "npx",
            "args": [
                "--yes",
                "node",
                "<path-to-project>/index.js"
            ],
            "disabled": false,
            "autoApprove": [
                "getSecretPassphrase"
            ]
        }
    }
}

Opciones de configuración:

super-secret : un identificador único para su servidor MCP
command : El comando para iniciar el servidor (npx en este caso)
args : Argumentos de la línea de comandos
- --yes : Aprobar automáticamente la instalación del paquete npm
- node : Ejecutar con Node.js
- <path-to-project>/index.js : Ruta a su archivo de servidor
disabled : si el servidor está deshabilitado
autoApprove : Lista de herramientas que se pueden ejecutar sin confirmación del usuario

El archivo de configuración debe ubicarse en:

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
macOS/Linux: $HOME/.codeium/windsurf/mcp_config.json

Pruebas

Inicie el servidor con MCP Inspector
Verificar la inicialización del servidor
Consultar lista de herramientas
Ejecución de la herramienta de prueba
Verificar formatos de respuesta

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

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

Expresiones de gratitud

Equipo de Protocolo de Contexto Modelo para la especificación del protocolo
Equipo de inspectores de MCP para la herramienta de pruebas

Mantente conectado

Síguenos en tus plataformas favoritas para obtener actualizaciones, noticias y debates de la comunidad:

Super Secret MCP Server

Integrations