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:
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 MCPcommand : 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 npmnode : Ejecutar con Node.js<path-to-project>/index.js : Ruta a su archivo de servidor
disabled : si el servidor está deshabilitadoautoApprove : 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: