Skip to main content
Glama

Super Secret MCP Server

by gbti-network

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

  1. Clone the repository:
git clone git@github.com:gbti-network/mcp-basic-test.git cd mcp-basic-test
  1. Install dependencies:
npm install

Running the Inspector

Start the server with MCP Inspector:

npx @modelcontextprotocol/inspector -- node index.js

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:

{ "type": "object", "properties": {}, "additionalProperties": false, "required": [] }

Example Response:

{ "content": [{ "type": "text", "text": "New England Clam Chowder" }] }

Project Structure

. ├── 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

Development

Adding New Tools

  1. Define your tool in 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'; } });
  1. 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:

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]"

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:

User: "What's the secret passcode?" Cascade: "Today's secret passcode is: Louisiana Gumbo 🍜"

Option 3: Persistent Memory

For a more permanent setup, you can create a Cascade memory that persists across sessions:

{ "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"] }

MCP Configuration

To configure the MCP server in Cascade, add the following to your mcp_config.json:

{ "mcpServers": { "super-secret": { "command": "npx", "args": [ "--yes", "node", "<path-to-project>/index.js" ], "disabled": false, "autoApprove": [ "getSecretPassphrase" ] } } }

Configuration options:

  • super-secret: A unique identifier for your MCP server
  • command: The command to start the server (npx in this case)
  • args: Command line arguments
    • --yes: Auto-approve npm package installation
    • node: Run with Node.js
    • <path-to-project>/index.js: Path to your server file
  • disabled: Whether the server is disabled
  • autoApprove: 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

  1. Start the server with MCP Inspector
  2. Verify server initialization
  3. Check tool listing
  4. Test tool execution
  5. Verify response formats

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. 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:

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

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.

  1. Features
    1. Getting Started
      1. Prerequisites
      2. Installation
      3. Running the Inspector
    2. Available Tools
      1. getSecretPassphrase
    3. Project Structure
      1. Development
        1. Adding New Tools
        2. Logging
      2. Using with Cascade
        1. Option 1: Direct Tool Usage
        2. Option 2: Natural Language Interface
        3. Option 3: Persistent Memory
        4. MCP Configuration
      3. Testing
        1. Contributing
          1. License
            1. Acknowledgments
              1. Stay Connected

                Related MCP Servers

                • A
                  security
                  F
                  license
                  A
                  quality
                  A lightweight, stateless MCP server utilizing Puppeteer for web searches, returning structured JSON results, easily integratable with other MCP-enabled systems.
                  Last updated 6 months ago
                  1
                  738
                  JavaScript
                • -
                  security
                  A
                  license
                  -
                  quality
                  A 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 ago
                  4
                  JavaScript
                  MIT License
                • -
                  security
                  A
                  license
                  -
                  quality
                  An 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 ago
                  17
                  TypeScript
                  MIT License
                • -
                  security
                  F
                  license
                  -
                  quality
                  A 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 ago
                  4
                  JavaScript

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/gbti-network/mcp-basic-test'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server