Skip to main content
Glama
Mock MCP Server

Mock MCP Server

by DiscreteTom

Mock MCP Server

PyPI - Version

A mock MCP server for testing MCP client implementations and development workflows.

Support tools, prompts and resources.

Usage

Full CLI Usage

 Usage: mock-mcp-server [OPTIONS]

 Mock MCP Server for testing.

╭─ Options ───────────────────────────────────────────────────────────────────────────╮
│ --transport  [stdio|http|sse|streamable-http]  Transport type [default: stdio]      │
│ --host       TEXT                              Host to bind to [default: 127.0.0.1] │
│ --port       INTEGER                           Port to bind to [default: 8000]      │
│ --version                                      Show version and exit                │
│ --help                                         Show this message and exit.          │
╰─────────────────────────────────────────────────────────────────────────────────────╯

Stdio

Add to your MCP client configuration:

Install MCP Server Add to Kiro

{
  "mcpServers": {
    "mock-stdio": {
      "command": "uvx",
      "args": ["mock-mcp-server"]
    }
  }
}

Streamable HTTP

Start server first:

uvx mock-mcp-server --transport http --host 127.0.0.1 --port 7788

Then configure your MCP client:

Install MCP Server Add to Kiro

{
  "mcpServers": {
    "mock-streamable-http": {
      "url": "http://127.0.0.1:7788/mcp"
    }
  }
}

SSE

Start server first:

uvx mock-mcp-server --transport sse --host 127.0.0.1 --port 7789

Then configure your MCP client:

Install MCP Server Add to Kiro

{
  "mcpServers": {
    "mock-sse": {
      "url": "http://127.0.0.1:7789/sse"
    }
  }
}

Related MCP server: http-mcp-server

CHANGELOG

Available Tools

1 tool
mock_echoB

Echo back the provided message.

Inputs: message (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The tool 'mock_echo' has a single, clear purpose of echoing messages, making it perfectly distinct.

    Naming Consistency5/5

    The tool name 'mock_echo' follows a consistent verb_noun pattern (echo as the verb, implied message as the noun). Since there is only one tool, naming consistency is inherently perfect with no deviations to assess.

    Tool Count2/5

    A single tool is generally too few for most server purposes, as it limits functionality and suggests a trivial or incomplete scope. For a server named 'Mock MCP Server', which implies broader mocking capabilities, one tool feels insufficient and under-scoped.

    Completeness2/5

    The server's purpose is unclear from the name 'Mock MCP Server', but a single echo tool suggests severe incompleteness. It lacks coverage for common mocking operations like simulating data, errors, or varied responses, creating significant gaps that could cause agent failures in typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A minimal demonstration server showcasing MCP protocol capabilities including tools, resources, and prompts with basic examples like hello world functionality.
      6 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Mock HTTP server implementing MCP (Model Context Protocol) with streamable HTTP transport, health endpoint, and example tools like echo and time.
      556 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A toy MCP server for exploring Model Context Protocol capabilities, including resources, tools, and prompts.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A lightweight mock MCP server for local testing and resilience experiments, providing predictable tool responses with simulated latency and errors.
      1
      MIT