🚀 FastMCP Boilerplate
About
A MCP server built with Python, FastMCP, Ollama, Open-webUI, FastAPI, and Docker following a microservice architecture..
Details
- Author
- rainer85ah
- GitHub stars
- 15
- Downloads
- 365
- Categories
- Developer Tools
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🚀 FastMCP BoilerplateCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, then run docker compose up --build -d to start all services. Access Ollama on port 11434, API docs at http://localhost:8000/docs, and Open-webUI on port 3000.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83d\ude80 fastmcp boilerplate": {
"mcp-server-rainer85ah": {
"command": "docker",
"args": [
"compose",
"up",
"--build",
"-d"
]
}
}
}
}McpServers
{
"mcp-server-rainer85ah": {
"command": "docker",
"args": [
"compose",
"up",
"--build",
"-d"
]
}
}🚀 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
git clone https://github.com/rainer85ah/mcp-server.git
cd mcp-server
🐳 2. Run with Docker Compose (recommended)
docker compose up --build -d
3. Access the app
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.
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
