Skip to main content
Glama

Test MCP

Diagram: https://excalidraw.com/#json=uRRaOjlO8rV6Og36vjPEj,LRARtOLrhz0VdTFIxjH8Rg

Requirements

Note: OpenRouter has many free models available that you can use for testing.

Related MCP server: My Awesome MCP

Development

For testing you can run a development server and manually run tool calls:

uv run fastmcp dev

The fully example is implemented in test-mcp.py, a minimal example you can use in your own projects is in minimal-mcp.py.

Installation

To install your MCP server you need to configure an MCP.json that looks something like this:

{
  "mcpServers": {
    "test-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/admin/Projects/test-mcp",
        "run",
        "test-mcp.py"
      ],
      "timeout": 600
    }
  }
}

For Claude Desktop there is a detailed guide available.

Available Tools

9 tools
cat_factA

Gets a random cat fact.

Inputs: no named parameters. Returns: result

find_inspirationA

Gets a random inspirational quote.

Inputs: no named parameters. Returns: result

get_email_bodyA

Gets the body of the email with the given UUID.

Inputs: uuid (required). Returns: result

get_weatherB

Gets the weather for the given city.

Inputs: city (required). Returns: result

list_emailsA

Gets the latest email metadata.

Inputs: no named parameters. Returns: result

reply_emailB

Replies to the email with the given UUID with the given body.

Inputs: body (required), uuid (required). Returns: result

say_helloA

Says hello to the user.

Inputs: name (required). Returns: result

suggest_bookB

Suggests a book to read.

Inputs: no named parameters. Returns: result

tell_jokeB

Tells a joke.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 9 tools

    Disambiguation4/5

    Each tool has a clearly distinct purpose (cat facts, weather, email, jokes, etc.), so there is minimal overlap. However, the wide variety of domains could confuse an agent about when to use which.

    Naming Consistency2/5

    Tool names are inconsistent: some use verb_noun (get_weather, list_emails), others use verb_phrase (tell_joke, find_inspiration), and one is noun_noun (cat_fact). No consistent pattern.

    Tool Count3/5

    The count of 9 tools is reasonable, but the server lacks a coherent domain; it feels like a random collection. For a single-purpose server it might be too many, but the number itself is not excessive.

    Completeness2/5

    No clear domain, so completeness is poor. Email tools have list, get, reply but no send or delete; weather is just a single lookup; other domains are single-tool only, leaving many gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server template built with FastMCP framework that provides example tools for echoing messages and retrieving server information. Serves as a starting point for building custom MCP servers with both stdio and HTTP transport support.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server template built with FastMCP framework that provides example tools for echoing messages and retrieving server information. Serves as a starting point for building custom MCP servers with support for both stdio and HTTP transports.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      This repository provides a template for creating MCP servers with Python, including installation instructions and tools for testing with the MCP Inspector.
      -