🚀 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
Metadata
Release files for iflow-mcp_rainer85ah-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_rainer85ah_mcp_server-0.1.0.tar.gz | 17.6 kB | Without provenance | Details for iflow_mcp_rainer85ah_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_rainer85ah_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_rainer85ah_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 43.8 kB
Release files / iflow_mcp_rainer85ah_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_rainer85ah_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 17.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
62478a81f2e6663dc08bb8c21b38452bdc79af0c97f1c2b156b59fbefaa794ec
|
|
BLAKE2b-256 checksum How to use checksums |
c2c386695bf479743f3e18ac3eb8cc00c62bd8e165646080f9221ab6efa33f74
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_rainer85ah_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_rainer85ah_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 26.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc72a41a4ff4afebac33aab6cc4d961f575044a63788e7d5888769d5d9525c2d
|
|
BLAKE2b-256 checksum How to use checksums |
18ed02c31919a98098796dbe3ed35feea232dc3328997c293bebc9699f42f9bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_rainer85ah-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.