Dockerized MCP Server Template

🚀 Dockerized MCP Server Template

This repository offers a reusable template for implementing the Model Context Protocol (MCP) in a Python server running within a Docker container. It utilizes Server-Sent Events (SSE) for real-time communication. Built on the FastMCP library, this template simplifies the integration with Large Language Models (LLMs).

🚀 Quick Start

Build and Run with Docker Compose

docker-compose up --build

The server will be accessible at:

http://localhost:3000/sse

Run Directly (Without Docker)

You can also run the server directly using Python. First, install the dependencies:

pip install -r src/requirements.txt

Then, run the server:

python src/server.py

The server will be accessible at:

http://localhost:3000/sse

✨ Features

What is MCP?

The Model Context Protocol (MCP) is a standard protocol specifically designed for interacting with large language models. MCP allows applications to clearly separate the concerns of providing context (data and functionality) to the LLM from the actual LLM interaction. An MCP server provides:

• Resources: Supplies data to the LLM (similar to a GET endpoint).
• Tools: Enables the LLM to perform operations or calculations (similar to a POST endpoint).
• Prompt Templates: Reusable templates for structured interactions with the LLM.

This template demonstrates a production-ready MCP server running in a Docker container, leveraging Server-Sent Events (SSE) for real-time communication.

📦 Installation

Project Structure

dockerized-mcp-server-template/
├── src/
│   ├── Dockerfile
│   ├── requirements.txt
│   └── server.py
├── docker-compose.yml
└── README.md

💻 Usage Examples

Basic Usage

The example includes a simple MCP tool function add:

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

You can call this tool via an MCP client request.

📚 Documentation

Resources

• MCP Documentation
• MCP Specification
• Server-Sent Events (SSE)