home / mcp / chuk mcp server reference

CHUK MCP Server Reference

A runnable MCP reference server demonstrating core MCP features and their practical usage.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "chrishayuk-chuk-mcp-server-reference": {
      "command": "python",
      "args": [
        "examples/11_full_server.py"
      ]
    }
  }
}

You can run a complete MCP server locally to explore every feature of the Model Context Protocol. This server acts as a practical, runnable reference you can use to learn, test clients, and validate integrations against the MCP specification.

How to use

Start by launching one of the provided local MCP servers from the examples. Each server runs as a separate Python process and exposes the MCP endpoints over STDIO so you can interact with it directly from your client or an IPC workflow. Use the minimal server to verify basic interactions, then move to the full server to exercise the complete feature set including tools, resources, prompts, and sampling.

How to install

Prerequisites: you need Python and a working internet connection to install dependencies and run the sample servers.

1) Create a working directory for the reference server examples.

Step-by-step setup

2) Install Python dependencies using pip.

3) Run one of the example servers to start the MCP service locally.

Run a sample server

# Minimal server example (STDIO)
python examples/01_minimal.py

# Tools basics example (STDIO)
python examples/02_tools_basic.py

# Full 2025-06-18 reference (STDIO)
python examples/11_full_server.py

Available tools

tools/list

List available tools defined for the MCP server, enabling clients to discover capabilities.

tools/call

Invoke a specific tool by name with the provided parameters and receive the tool result.