Super Secret MCP Server

Name: Super Secret MCP Server
Author: gbti-network

@gbti-network

Repository

About Super Secret MCP Server

Example node MCP server. When a user asks the agent for the passphrase, a special code phase is provided.

#boilerplate #mcp #node-js #model-context-protocol #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-basic-test": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "--",
        "node",
        "index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Super Secret MCP Server?

Super Secret MCP Server is a Model Context Protocol (MCP) server implemented in pure Node.js. It provides a single fun tool that generates random combinations of a US State and its signature soup (e.g., “Louisiana Gumbo”). It is intended for developers and users who want to test MCP integration or add a whimsical secret‑passphrase feature to their AI assistants.

How to use Super Secret MCP Server?

Clone the repository, install dependencies with npm install, then start the server with npx @modelcontextprotocol/inspector -- node index.js. The server runs over STDIO transport and exposes the getSecretPassphrase tool. In Cascade (Windsurf), configure the server by adding an entry to the mcp_config.json file with the appropriate command and arguments.

Key features of Super Secret MCP Server

Pure Node.js implementation, no external MCP dependencies
JSON‑RPC 2.0 compliant (MCP protocol 2024‑11‑05)
STDIO transport for local AI assistant integration
Single tool getSecretPassphrase with schema validation
Custom logging system (DEBUG, INFO, WARN, ERROR)
Supports direct tool use and natural language interface via Cascade

Use cases of Super Secret MCP Server

Generating a fun, random secret passphrase for daily team unlock
Demonstrating MCP tool integration with a simple output
Serving as a test harness for MCP Inspector or similar tools
Adding a playful “today’s passcode” feature to an AI assistant

FAQ from Super Secret MCP Server

What does the `getSecretPassphrase` tool return?

It returns a random US State and its signature soup combination, for example “New England Clam Chowder” or “Texas Chili”.

What are the runtime requirements for Super Secret MCP Server?

Node.js (latest LTS version recommended) is required. The server runs with standard Node.js and does not need additional global packages beyond those installed via npm install.

How do I test the server?

Use the MCP Inspector: start the server with npx @modelcontextprotocol/inspector -- node index.js, then list tools and test the getSecretPassphrase tool.

How do I configure Super Secret MCP Server with Cascade/Windsurf?

Add an entry to your mcp_config.json with the command npx, arguments including --yes node <path-to-project>/index.js, and auto‑approve getSecretPassphrase. Place the config file at %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows) or $HOME/.codeium/windsurf/mcp_config.json (macOS/Linux).

Where are the server logs stored?

Logs are written to the .logs directory in the project root, using the custom logging system.

Comments

More Developer Tools MCP servers

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K