https://github.com/therealumerhayat/mcp---agent-starter-kit
Starter pack for building AI-powered chatbots, multi-agent workflows, and MCP servers. Includes a website Q/A bot, MCP docs server, and multi-agent orchestration examples with FastAPI and OpenAI integration.
https://github.com/therealumerhayat/mcp---agent-starter-kit
ai automation chatbot demo fastapi mcp mcp-server multi-agent openai pinecone rag vector-database workflow
Last synced: 3 months ago
JSON representation
Starter pack for building AI-powered chatbots, multi-agent workflows, and MCP servers. Includes a website Q/A bot, MCP docs server, and multi-agent orchestration examples with FastAPI and OpenAI integration.
- Host: GitHub
- URL: https://github.com/therealumerhayat/mcp---agent-starter-kit
- Owner: therealumerhayat
- Created: 2025-09-30T06:35:14.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-30T06:52:27.000Z (9 months ago)
- Last Synced: 2025-09-30T08:39:26.076Z (9 months ago)
- Topics: ai, automation, chatbot, demo, fastapi, mcp, mcp-server, multi-agent, openai, pinecone, rag, vector-database, workflow
- Language: Python
- Homepage: https://www.linkedin.com/in/therealumerhayat/
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MCP & Agent Starter Kit
A collection of minimal, production-ready starter projects for building multi-agent and retrieval-augmented AI workflows.
This kit includes three main components:
- **mcp-docs-server:** Exposes a folder of documents as a tool via REST API and optional MCP agent integration.
- **website-qa-bot:** Retrieval-Augmented Generation (RAG) Q/A bot for websites and documents, with Pinecone and OpenAI integration.
- **multi-agent-workflow:** Demonstrates multi-agent orchestration for collaborative AI tasks.
---
## Projects Overview
### 1. mcp-docs-server
- FastAPI server to serve documents from a local folder.
- REST endpoints for listing and retrieving documents.
- Optional MCP integration via `fastmcp` for agent workflows.
### 2. website-qa-bot
- Upload text or PDF files, store embeddings in Pinecone.
- Semantic search and context-aware answers using OpenAI LLM.
- FastAPI backend with endpoints for ingestion and querying.
### 3. multi-agent-workflow
- Orchestrates multiple AI agents (Researcher, Summarizer, Planner).
- Demonstrates agent collaboration for solving tasks.
- OpenAI integration for summarization, mock mode available.
---
## Setup
1. Clone this repository and navigate to the desired project folder.
2. Copy `.env.example` to `.env` in each project and add your API keys.
3. Install dependencies for each project:
```bash
pip install -r requirements.txt
```
4. Run the server for each project (see individual README files for details).
---
## File Tree
```
MCP & Agent Starter Kit/
├─ mcp-docs-server/
│ ├─ app/
│ │ ├─ server.py
│ │ ├─ mcp_adapter.py
│ │ ├─ docs/
│ │ │ ├─ README.md
│ │ │ └─ sample-doc.md
│ ├─ requirements.txt
│ ├─ .env.example
│ ├─ README.md
├─ website-qa-bot/
│ ├─ app/
│ │ ├─ main.py
│ │ ├─ ingest.py
│ │ ├─ query.py
│ │ ├─ utils.py
│ ├─ requirements.txt
│ ├─ .env.example
│ ├─ README.md
├─ multi-agent-workflow/
│ ├─ app/
│ │ ├─ agents.py
│ │ ├─ orchestrator.py
│ ├─ requirements.txt
│ ├─ .env.example
│ ├─ README.md
```
---
## Author / Contact
**Name:** Muhammad Umer
**Email:** umerhayat282@gmail.com
**LinkedIn:** [Muhammad Umer](https://www.linkedin.com/in/therealumerhayat/)
Feel free to connect for collaboration, freelance projects, or questions about multi-agent workflows.