Skip to main content
Glama
gitcommit-computerphile

minimal-mcp

by gitcommit-computerphile
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

minimal-mcp

The smallest MCP server that still covers the whole protocol: one file, one todo list, all three primitives, plus elicitation.

uv sync
uv run python smoke_test.py       # proves it works -- 12 checks
uv run mcp dev todo_server.py     # MCP Inspector -- poke at it in a browser

The one thing to remember

Each MCP primitive is defined by who decides to use it:

Primitive

Decided by

Here

Tools

the model

add_todo, complete_todo, remove_todo

Resources

the application

todos://all, todos://todo/{id}

Prompts

the user

plan_my_day

remove_todo also demonstrates elicitation — the tool pauses mid-call to ask the user "really delete this?" before acting. That's a capability a plain REST endpoint has no way to express.

Related MCP server: Basic MCP Server

Why one file

Everything lives in todo_server.py, top to bottom, in the order you'd want to read it: storage → wire types → server → tools → resources → prompts. No navigating between files to see the whole picture.

Storage is a plain in-memory dict — restarting clears it. That's deliberate: this project is about the protocol, not persistence.

Connecting it to a real host

claude mcp add todos -- uv --directory "<absolute path to this repo>" run python todo_server.py

Not yet verified against a real host — only against the Inspector and the smoke test.

Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Basic MCP Server

    gurdasnijor
    A
    license
    -
    quality
    D
    maintenance
    A minimal demonstration server showcasing MCP protocol capabilities including tools, resources, and prompts with basic examples like hello world functionality.
    Last updated
    6
    MIT

  • Basic MCP Server

    cyberimaginationsi-gif
    A
    license
    -
    quality
    D
    maintenance
    A minimal template MCP server demonstrating basic tools, resources, and prompts functionality. Includes example implementations like a hello tool, history resource, and greet prompt for learning MCP development.
    Last updated
    6
    ISC

  • emi_mcp_server

    EmiRoberti77
    F
    license
    -
    quality
    D
    maintenance
    A sample MCP server that exposes tools, resources, and prompts for managing users and todos, supporting both stdio and Streamable HTTP transports.
    Last updated

  • task-manager-mcp

    doberoi21
    F
    license
    -
    quality
    C
    maintenance
    A task manager MCP server that demonstrates all three MCP primitives (tools, resources, prompts). Enables users to manage tasks, read task summaries and details, and run structured planning/review prompts through natural language.
    Last updated

View all related MCP servers

Related MCP Connectors

  • PlanExe

    MCP server for generating rough-draft project plans from natural-language prompts.

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

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/gitcommit-computerphile/Custom-MCP-Server'

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