Simple HTTP MCP Server

Simple HTTP MCP Server

This project provides a lightweight server implementation for the Model Context Protocol (MCP) over HTTP. It allows you to expose Python functions as "tools" that can be discovered and executed remotely via a JSON-RPC interface. It is thought to be used with an Starlette or FastAPI application (see app/main.py).

How to test with Gemini Cli

1. Install dependencies:
   uv sync uv run run-app
2. Test the server:Note: you should be located on the root folder of the project so gemini config is used.
   gemini /mcp # This should show the tools available

Example:

Features

• MCP Protocol Compliant: Implements the MCP specification for tool discovery and execution.
• HTTP Transport: Uses HTTP POST for communication.
• Async Support: Built on Starlette or FastAPI for asynchronous request handling.
• Type-Safe: Leverages Pydantic for robust data validation and serialization.
• Dependency Management: Uses uv for fast and efficient package management.
• Linting: Integrated with Ruff for code formatting and linting.
• Type Checking: Uses Mypy for static type checking.

Getting Started

Prerequisites

• uv

Installation

1. Clone the repository:
   git clone <repository-url> cd simple-http-mcp
2. Create a virtual environment and install dependencies:
   uv venv source .venv/bin/activate uv sync

Usage

For usage examples, please refer to the tests in the tests/ directory.

Development

This project uses several tools to ensure code quality.

Linting

To check for linting errors, run:

To automatically fix linting errors, run:

Type Checking

To run the static type checker, use: