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

Related MCP server: Vercel MCP Python Server

Empezando

Prerrequisitos

• Node.js (se recomienda la última versión LTS)

• Inspector MCP para pruebas

Instalación

1. Clonar el repositorio:

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

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

1. 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';
    }
});

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

1. Inicie el servidor con MCP Inspector

2. Verificar la inicialización del servidor

3. Consultar lista de herramientas

4. Ejecución de la herramienta de prueba

5. Verificar formatos de respuesta

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones

3. Confirme sus cambios

4. Empujar hacia la rama

5. 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:

• Twitter/X

• GitHub

• YouTube

• Desarrollador a

• Daily.dev

• Nodo hash

• Discordia

• Reddit