MCP Catalogs
Home

template-mcp-server

by redhat-data-and-ai·54·Score 48

A production-ready Python template for building MCP servers with FastMCP, FastAPI, OAuth, and deployment examples.

developer-toolsops-infraai-llm
56
Forks
35
Open issues
this month
Last commit
2d ago
Indexed

Overview

This is a comprehensive MCP server template from Red Hat that provides a solid foundation for developing production MCP servers. It includes three example tools (multiply calculator, code review prompt generator, and Red Hat logo tool) and demonstrates best practices for MCP development including proper error handling, health checks, multiple transport protocols, SSL support, and structured logging. The template also includes OAuth integration with PostgreSQL token storage and deployment configurations for OpenShift.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Rapidly deploy new MCP servers using proven patterns
you:Create custom MCP tools for specific domain applications
you:Implement secure MCP services with OAuth authentication
you:What transport protocols are supported?
you:Can I use this template for production deployment?

When to choose this

Choose this template when starting a new MCP server project, especially if you need production-ready features like OAuth authentication, container deployment, and CI/CD integration.

When NOT to choose this

Don't choose this if you're building a simple proof-of-concept or if you need a different programming language (this template is Python-specific).

Tools this server exposes

3 tools extracted from the README
  • multiply_calculator

    A calculator that multiplies two numbers

  • code_review_prompt_generator

    Generates a prompt for reviewing code

  • red_hat_logo_tool

    Returns a Red Hat logo image

Comparable tools

mcp-fastapi-templatemcp-server-boilerplatemcp-typescript-templatemcp-rust-template

Installation

Installation

Quick Start

git clone https://github.com/redhat-data-and-ai/template-mcp-server
cd template-mcp-server
make install        # creates venv, installs deps + pre-commit hooks
make local          # starts server on localhost:5001

Manual Setup

# Create venv and install
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pre-commit install

# Configure and run
cp .env.example .env
template-mcp-server

Claude Desktop Configuration

{
  "mcpServers": {
    "template-mcp-server": {
      "command": "uv",
      "args": ["run", "template-mcp-server"],
      "env": {
        "MCP_HOST": "localhost",
        "MCP_PORT": "5001"
      }
    }
  }
}

FAQ

What transport protocols are supported?
The template supports HTTP, SSE (Server-Sent Events), and streamable-HTTP protocols for MCP communication.
Can I use this template for production deployment?
Yes, this is a production-ready template with SSL support, containerization, and OpenShift deployment manifests included.

Compare template-mcp-server with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.