Metadata-Version: 2.4
Name: iflow-mcp_rainer85ah-mcp-server
Version: 0.1.0
Summary: MCP Server using FastMCP, and FastAPI.
Author-email: Rainer Arencibia <rainer85ah@gmail.com>
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.115.12
Requires-Dist: fastmcp>=2.5.2
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.9.0
Requires-Dist: motor>=3.4.0
Requires-Dist: boto3>=1.38.26
Requires-Dist: aiohttp>=3.12.4
Requires-Dist: asyncpg>=0.30.0
Requires-Dist: psycopg2-binary>=2.9.10
Requires-Dist: redis>=6.2.0
Requires-Dist: botocore>=1.38.26
Requires-Dist: tenacity>=9.1.2
Provides-Extra: dev
Requires-Dist: pytest>=8.3.5; extra == "dev"
Requires-Dist: pytest-asyncio>=0.26.0; extra == "dev"

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.12%2B-blue.svg)](https://www.python.org/)
[![Docker](https://img.shields.io/badge/Docker-Ready-blue)](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.

![Model Control Protocol (MCP)](utils/MCP.gif)
---

## 🔧 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)
