Super Secret MCP Server
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
Clonar el repositorio:
git clone git@github.com:gbti-network/mcp-basic-test.git
cd mcp-basic-testInstalar dependencias:
npm installEjecución del Inspector
Inicie el servidor con MCP Inspector:
npx @modelcontextprotocol/inspector -- node index.jsEl 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 directoryDesarrollo
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.jsonmacOS/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:
Available Tools
1 toolgetSecretPassphraseD
Whats the password?
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is singular and clearly defined, so disambiguation is perfect.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The naming follows a clear verb_noun pattern (getSecretPassphrase).
One tool is too few for most server purposes, as it severely limits functionality and scope. This feels thin and incomplete, even for a simple server, unless it's intentionally minimalistic.
The server's purpose is unclear from the single tool, but a 'secret passphrase' domain would typically require more operations (e.g., set, update, list, delete). With only a get operation, the surface is severely incomplete and will likely cause agent failures.
Maintenance
Related MCP Connectors
A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready
An MCP server that provides congressional transcripts
Hosted MCP server to manage a restaurant menu from AI agents - 39 tools over the DuckHub API.
One MCP server exposing every tool in the Gumball portfolio.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA beginner-friendly MCP-inspired JSON-RPC server built with Node.js, offering basic client-server interaction through an 'initialize' capabilities handshake and an 'echo' function.3MIT
- AlicenseNot gradedqualityDmaintenanceA serverless MCP server deployed on Vercel that provides basic utility tools including echo, time retrieval, arithmetic operations, and mock weather information. Includes an interactive client application for testing and demonstration purposes.MIT
- FlicenseNot gradedqualityDmaintenanceA modular MCP server that provides tools for looking up country and state information. Designed as a demonstration of building extensible MCP servers with custom tool modules.-
- AlicenseNot gradedqualityDmaintenanceA basic MCP server implementation using Node.js and TypeScript that bridges AI models with external tools and data sources via JSON-RPC.2ISC