Simple MCP Servers

What is Simple MCP Servers?

Simple MCP Servers is a repository of self-contained, single-file MCP (Model Context Protocol) servers written in Python. They are designed for easy integration into Claude Desktop or other MCP-compatible applications.

How to use Simple MCP Servers?

Ensure Python ≥3.11 and uv are installed. Run a server with uv run --script <filename>.py or execute the file directly if it is marked executable. For Claude Desktop, add a server entry under mcpServers in the configuration JSON.

Key features of Simple MCP Servers

• Self-contained single Python files with embedded dependencies
• PEP 723 inline script metadata for dependency management
• Direct execution via uv or as standalone scripts
• No external dependency files (e.g., requirements.txt) needed
• Uses fastmcp and pydantic libraries under the hood

Use cases of Simple MCP Servers

• Convert deer.social URLs to Bluesky-compatible AT URI formats
• Read large files in configurable chunks (line‑based, head/tail, byte‑based, pattern search)
• Validate Scrabble words against the complete SOWPODS word list
• Integrate any of the above servers into Claude Desktop or MCP‑compatible apps

FAQ from Simple MCP Servers

What are the prerequisites for using Simple MCP Servers?

Python version 3.11 or higher and the uv package manager are required.

How do I run a Simple MCP Server?

You can run it directly if the file is executable (e.g., ./deer_to_bsky.py) or use uv run --script <filename>.py.

How do I add a server to Claude Desktop?

Add an entry under mcpServers in your Claude Desktop configuration JSON, specifying the path to uv and the script file.

What dependencies do the servers use?

All servers depend on fastmcp (MCP framework) and pydantic (data validation), declared inline via PEP 723.

How can I create a new MCP server for this repository?

Start with the PEP 723 header, follow the existing pattern, and make the file executable with chmod +x.