rainer85ah

๐Ÿš€ FastMCP Boilerplate

Community rainer85ah
Updated

A MCP server built with Python, FastMCP, Ollama, Open-webUI, FastAPI, and Docker following a microservice architecture..

License: MITPythonDocker

๐Ÿš€ FastMCP Boilerplate

A modern MCP (Model Control Plane) project built with Python, FastMCP, FastAPI, Docker, and integrated with Ollama and Open-webUI.

This project provides a lightweight, extensible foundation for building and deploying intelligent systems that manage and expose AI/LLM capabilities.

๐Ÿ”ง Tech Stack

  • ๐Ÿ Python โ€“ Primary language
  • โšก FastMCP โ€“ Model Control Plane framework for managing AI models
  • ๐ŸŒ FastAPI โ€“ High-performance API backend
  • ๐Ÿง  Ollama โ€“ LLM execution and orchestration
  • ๐Ÿงฉ Open-webUI โ€“ Chat-style interface for AI interactions
  • ๐Ÿณ Docker โ€“ Containerized for easy deployment and reproducibility in dev and production environments.

๐Ÿงฑ Features

  • ๐Ÿš€ Fast startup with Docker
  • ๐Ÿ”Œ Easy integration with Ollama and Open-webUI
  • ๐Ÿ“ฆ Pluggable architecture for adding models and routes
  • ๐ŸŽฏ Designed for rapid prototyping or production use
  • โœ… REST API ready with OpenAPI docs

๐Ÿ“ฆ Getting Started

1. Clone the repo

git clone https://github.com/rainer85ah/mcp-server.git
cd mcp-server

๐Ÿณ 2. Run with Docker Compose (recommended)

docker compose up --build

3. Access the app

Ollama: http://localhost:11434
API Docs: http://localhost:8000/docs
Open-webUI: http://localhost:3000

๐ŸŒฑ Use as a Boilerplate

Use this project as a starter template for:

  • AI chat platforms
  • Model routing gateways
  • Developer LLM sandboxes
  • FastAPI-based ML backends

๐Ÿ“œ License

This project is licensed under the MIT License. You are free to use, modify, and distribute this software with proper attribution.

๐Ÿค Contributing

Contributions are welcome! Feel free to:

  • โญ Star the project
  • ๐Ÿด Fork the repo
  • ๐Ÿ› ๏ธ Open issues or feature requests
  • ๐Ÿ” Submit pull requests

๐Ÿ“ซ Contact

Created with ๐Ÿ’ก by Rainer Arencibia ๐Ÿ”— Connect with me on LinkedIn

MCP Server ยท Populars

MCP Server ยท New