파이썬과 FastMCP를 사용하여 Model Context Protocol (MCP) 서버를 개발하는 데 필요한 템플릿을 제공합니다. 이 서버는 MCP-compliant 서버를 만들기 위한 기반을 제공합니다. 종합적인 도구, 구조화된 로깅, 구성 관리, 컨테이너화된 배포.

템플릿에는 세 가지 예 MCP 도구가 포함되어 있습니다 : 멀티플 계산기, 코드 검토 프롬프트 생성기 및 Red Hat 로고 도구. 적절한 오류 처리, 건강 검사, 여러 전송 프로토콜 (HTTP, SSE, streamable-HTTP), SSL 지원 및 종합 개발 툴링을 포함한 MCP 서버 개발을위한 모범 사례를 보여줍니다.

특징

• FastMCP + FastAPI 다중 전송 프로토콜 (HTTP, SSE, streamable-HTTP)
• ** 세 가지 예 도구 ** : 곱하기 계산기, 코드 검토 프롬프트, Red Hat 로고
• Pydantic configuration 환경 변수를 통해 -Structured JSON 로깅 와 structlog
• SSL/TLS 지원 안전한 배포 -Container-ready Red Hat UBI 기본 이미지
• **OpenShift 배포 ** 표시 포함 -Full CI/CD with GitHub Actions (테스트, 라이팅, 보안, 릴리스)
• **OAuth 통합 ** PostgreSQL 토큰 저장

Template MCP Server

A production-ready template for developing Model Context Protocol (MCP) servers using Python and FastMCP. This server provides a foundation for creating MCP-compliant servers with comprehensive examples of tools, structured logging, configuration management, and containerized deployment.

The template includes three example MCP tools: a multiply calculator, a code review prompt generator, and a Red Hat logo tool. It demonstrates best practices for MCP server development including proper error handling, health checks, multiple transport protocols (HTTP, SSE, streamable-HTTP), SSL support, and comprehensive development tooling.

Features

• FastMCP + FastAPI with multiple transport protocols (HTTP, SSE, streamable-HTTP)
• Three example tools: multiply calculator, code review prompt, Red Hat logo
• Pydantic configuration via environment variables
• Structured JSON logging with structlog
• SSL/TLS support for secure deployments
• Container-ready with Red Hat UBI base image
• OpenShift deployment manifests included
• Full CI/CD with GitHub Actions (tests, linting, security, releases)
• OAuth integration with PostgreSQL token storage

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

Pre-commit includes gitleaks (staged changes) and detect-private-key for secret scanning; CI also runs a full-repository Gitleaks scan. Also enable GitHub Secret Scanning and Push Protection on the repository for defense in depth.

Verify in another terminal:

curl http://localhost:5001/health

How to Use This Template