FastMCP Boilerplate

[](LICENSE) [](https://www.python.org/) [](https://www.docker.com/) # 🚀 FastMCP Boilerplate for MCP Servers A modern **MCP (Model Control Protocol)** 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 Protocol 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 ```bash git clone https://github.com/rainer85ah/mcp-server.git cd mcp-server ``` ### 🐳 2. Run with Docker Compose (recommended) ```bash docker compose up --build -d ``` ### 3. Access the app ```bash Ollama: http://localhost:11434 API Docs: http://localhost:8000/docs OpenAPI: http://localhost:8000/openapi.json MCP Server: http://localhost:8000/service/mcp/ 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](https://opensource.org/license/mit). 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](https://www.linkedin.com/in/rainer-arencibia)