Test

A sample MCP server exposing three tools that fetch quotes, jokes, and advice from public APIs.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pkj-m-test-mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/test-mcp/src/test_mcp_server.py"
      ]
    }
  }
}

You can run a minimal MCP server that exposes three tools to fetch data from public APIs. This server communicates via stdio, making it easy to integrate with your preferred MCP client and quick to extend with new tools.

How to use

You use an MCP client to connect to the local MCP server process. Start the server and point your client to the stdio channel. You can run the server directly from your environment or configure an MCP client to launch it automatically.

How to install

Prerequisites: Python 3.10 or newer must be installed on your system.

pip install -r requirements.txt

Alternatively, install the package in editable mode to develop locally.

pip install -e .

Run the server directly in your environment.

python src/test_mcp_server.py

Configure your MCP client to connect via stdio using the following example, which shows the local path you would replace with your actual directory structure.

{
  "mcpServers": {
    "test_mcp_server": {
      "command": "python",
      "args": ["/absolute/path/to/test-mcp/src/test_mcp_server.py"]
    }
  }
}

Additional notes

The server provides three tools to fetch data from public APIs. It includes an example configuration for Claude Desktop integration so you can run it as part of your workspace setup.

{
  "mcpServers": {
    "test-mcp-server": {
      "command": "python",
      "args": ["/absolute/path/to/test-mcp/src/test_mcp_server.py"]
    }
  }
}

Available tools

get_quote

Fetches a random inspirational quote from a public API.

get_joke

Fetches a random programming joke from a public API.

get_advice

Fetches random general advice from a public API.