Simple MCP Servers
About
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.
Details
- Author
- Jython1415
- Downloads
- 271
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Simple MCP ServersCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"simple mcp servers": {
"simple-mcp-servers": {
"command": "uv",
"args": [
"run",
"--script",
"deer_to_bsky.py"
]
}
}
}
}McpServers
{
"simple-mcp-servers": {
"command": "uv",
"args": [
"run",
"--script",
"deer_to_bsky.py"
]
}
}Simple MCP Servers
Repository for holding one-file MCP servers written in Python
Overview
This repository contains self-contained, single-file MCP (Model Context Protocol) servers that can be easily integrated into Claude Desktop or other MCP-compatible applications. Each server is designed to be standalone with dependencies declared using PEP 723 inline script metadata.
Features
- Self-contained scripts - Each MCP server is a single Python file with embedded dependencies
- PEP 723 compliant - Uses inline script metadata for dependency management
- Direct execution - Scripts can be run directly with uv or executed as standalone programs
- No setup required - Dependencies are automatically handled by uv at runtime
Available MCP Servers
1. deer_to_bsky.py
Converts deer.social URLs to Bluesky-compatible AT URI formats for seamless integration with Bluesky tools.
2. large_file_reader_mcp.py
Provides efficient methods for reading large files in chunks, including line-based reading, head/tail operations, byte-based access, and pattern searching with context.
3. time_god_mcp.py
A Scrabble word validation server containing the complete SOWPODS word list for word game applications.
Installation & Usage
Prerequisites
- Python >= 3.11 - uv package managerRunning a Server
Each server can be run in multiple ways:
Method 1: Direct execution (if executable)
./deer_to_bsky.py
Method 2: Using uv
uv run --script deer_to_bsky.py
Claude Desktop Configuration
Add any server to your Claude Desktop configuration:
{
"mcpServers": {
"deer-to-bsky": {
"command": "/path/to/uv",
"args": [
"run",
"--script",
"/path/to/deer_to_bsky.py"
]
}
}
}
Development
Creating a New MCP Server
1. Start with the PEP 723 header:
```python
#!/usr/bin/env -S uv run --script
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
