The Super Secret MCP Server is a Node.js server that generates random US State and soup combinations as passphrases. It offers:
- Random Passphrase Generation: Creates combinations like 'New England Clam Chowder' using the
getSecretPassphrase
tool - JSON-RPC 2.0 Compliance: Follows standard protocol for remote procedure calls
- STDIO Transport: Communicates via standard input/output for easy integration
- Custom Logging System: Provides multiple severity levels (DEBUG, INFO, WARN, ERROR) with logs stored in a
.logs
directory - Tool Support with Schema Validation: Validates input parameters for tools
- Integration Options: Works with MCP Inspector for testing and Cascade for natural language interactions
- Extensibility: Allows adding new tools by defining them in the
index.js
file
Provides links to the service for updates and community discussions via daily.dev
Offers integration with dev.to for sharing updates and connecting with the community
Connects users to the GBTI Network Discord community through membership links
Enables users to access the project repository and follow updates through GitHub
Provides connection to the GBTI Network's Hashnode blog for updates and articles
Links to the GBTI Network subreddit for community discussions and updates
Connects to the GBTI Network YouTube channel for video content and updates
Super Secret MCP Server
A Model Context Protocol (MCP) server implementation in pure Node.js that provides a fun tool to generate random US State and signature soup combinations.
Features
- Pure Node.js implementation
- JSON-RPC 2.0 compliant
- MCP protocol version: 2024-11-05
- Custom logging system
- Tool support with schema validation
- STDIO transport
Getting Started
Prerequisites
- Node.js (Latest LTS version recommended)
- MCP Inspector for testing
Installation
- Clone the repository:
- Install dependencies:
Running the Inspector
Start the server with MCP Inspector:
The server will start and be available for connections via STDIO.
Available Tools
getSecretPassphrase
Returns a random combination of a US State and its signature soup. Examples include:
- New England Clam Chowder
- Louisiana Gumbo
- Texas Chili
- California Cioppino
- Michigan Cherry Soup
Input Schema:
Example Response:
Project Structure
Development
Adding New Tools
- Define your tool in
index.js
:
- Test using MCP Inspector:
- Connect to server
- Use "List Tools" to verify tool registration
- Test tool execution
Logging
The server uses a custom logging system with multiple levels:
- DEBUG: Detailed debugging information
- INFO: General operational information
- WARN: Warning messages
- ERROR: Error conditions
Logs are stored in the .logs
directory.
Using with Cascade
Option 1: Direct Tool Usage
When the MCP server is loaded in Cascade, you can directly use the getSecretPassphrase
tool to generate state-soup combinations.
Option 2: Natural Language Interface
To make the tool more user-friendly, you can set up Cascade to respond to natural language queries about secret passcodes. Here's an example prompt:
This will allow users to get passcodes using natural questions like:
- "What's the secret passcode?"
- "Tell me the secret code"
- "What's today's passcode?"
- "Give me the secret"
Example interaction:
Option 3: Persistent Memory
For a more permanent setup, you can create a Cascade memory that persists across sessions:
MCP Configuration
To configure the MCP server in Cascade, add the following to your mcp_config.json
:
Configuration options:
super-secret
: A unique identifier for your MCP servercommand
: The command to start the server (npx in this case)args
: Command line arguments--yes
: Auto-approve npm package installationnode
: Run with Node.js<path-to-project>/index.js
: Path to your server file
disabled
: Whether the server is disabledautoApprove
: List of tools that can be run without user confirmation
The config file should be placed at:
- Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS/Linux:
$HOME/.codeium/windsurf/mcp_config.json
Testing
- Start the server with MCP Inspector
- Verify server initialization
- Check tool listing
- Test tool execution
- Verify response formats
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Model Context Protocol team for the protocol specification
- MCP Inspector team for the testing tool
Stay Connected
Follow us on your favorite platforms for updates, news, and community discussions:
Tools
A Node.js-based MCP server implementing JSON-RPC 2.0, allowing users to generate random US State and signature soup combinations through a fun and simple tool.
- Features
- Getting Started
- Available Tools
- Project Structure
- Development
- Using with Cascade
- Testing
- Contributing
- License
- Acknowledgments
- Stay Connected
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA lightweight, stateless MCP server utilizing Puppeteer for web searches, returning structured JSON results, easily integratable with other MCP-enabled systems.Last updated 6 months ago1738JavaScript
- -securityAlicense-qualityA 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.Last updated 6 months ago4JavaScriptMIT License
- -securityAlicense-qualityAn MCP server that enables coordination of agents through shared finite state machines (puzzles) where clients can create, monitor, and trigger state transitions of stateful resources.Last updated 25 days ago17TypeScriptMIT License
- -securityFlicense-qualityA Node.js module that provides an MCP Server connecting to MCP Bone online service, allowing users to register other MCP Servers, obtain function calling tools in JSON or XML format, and parse completion text into tool calls.Last updated 3 months ago4JavaScript