partychen/remote-mcp-server-python

Remote MCP Server (Python)

This project implements a remote Model Context Protocol (MCP) server in Python.

Features

• Remote MCP server implementation
• Python-based, easy to extend
• Simple to run and configure

Requirements

• Python 3.8+
• (Optional) See pyproject.toml for dependencies

Installation & Configuration

1. Clone this repository:

   git clone <repo-url>
   cd remote-mcp-server-python
   

2. (Optional) Create and activate a virtual environment:

   python3 -m venv venv
   source venv/bin/activate
   

3. Install dependencies using uv:

   uv install .
   

   Or, with pip:

   pip install .
   

Project Configuration

• All dependencies are managed in pyproject.toml under the [project] section.
• The main dependency is mcp[cli]>=1.9.3.
• Python version required: 3.13 or above (see requires-python in pyproject.toml).
• The entry point is main.py, which starts the MCP server.

You can customize the server by editing main.py and adjusting the FastMCP initialization or adding new tools.

Usage

Run the server with uv:

uv run main.py

Or, directly with Python:

python main.py

By default, the server runs in stateless HTTP mode and responds with JSON. You can change the transport or server options in main.py.

Project Structure

• main.py — Main entry point for the server, defines tools and server config
• pyproject.toml — Project metadata and dependencies
• README.md — This file

License

MIT