README.md

---
HF username: WhoDat55
title: 'Project Conductor: Core MCP Server'
emoji: ⚙️
colorFrom: red
colorTo: yellow
sdk: docker
sdk_port: 7860
pinned: true
license: mit
Track Tag: "building-mcp-track-1"
tags:
  - building-mcp-track-creative
  - building-mcp-track-enterprise
  - building-mcp-track-consumer
---

# Project: Conductor (Core MCP Server)

This is the powerhouse backend for Project Conductor, submitted for the MCP's 1st Birthday Hackathon. It demonstrates **Track 1: Building MCP**.

This FastAPI server exposes a robust, multi-agent workflow via a streaming API endpoint. It's a reusable engine designed to extend LLM capabilities with structured reasoning, fault-tolerant tool use, and a clear separation of concerns. It is showcased by our **[Project Conductor Client GUI](https://huggingface.co/spaces/MCP-1st-Birthday/Conductor-GUI)**.

---

### ⭐ Core Capabilities

*   **⚡ Streaming API Endpoint (`/execute_stream`):** Built for modern, interactive applications. The server uses Server-Sent Events (SSE) to provide a real-time stream of the entire agentic process, enabling dynamic and transparent user experiences.
*   **🛡️ Resilient Agentic Workflow:** Orchestrates a workflow between two specialized AI agents (a "Coder" and a "Strategist") to resolve complex tasks. The system is designed to intelligently handle ambiguity, escalate issues, and recover from external tool failures without crashing.
*   **🔧 Modular Tool Integration:** Features a well-structured `TOOL_REGISTRY` that makes it easy to add new capabilities. All tool calls are logged with unique transaction IDs for detailed auditing.
*   **🔒 Professional Grade Design:** Includes robust configuration management (`config.ini` & environment variables) and security-conscious error sanitization, making the server both powerful and deployable.

---

### 🏛️ A Universal Framework

While this demo showcases a developer-focused "Coder/Strategist" workflow, the underlying Conductor engine is a universal, resilient framework for any multi-agent task. The core logic—escalating ambiguity, leveraging tools, and handling failure—is designed to be domain-agnostic. This pattern could be re-skinned for **Enterprise** (e.g., automated auditing), **Consumer** (e.g., complex trip planning), or any other **Creative** application.

---

### 🎬 Demo Video

The full power of this server is demonstrated through our client GUI. The video showcases the streaming data, tool calls, and fault tolerance in action.

You-Tube: https://youtu.be/fSzvcKMXLCU

---

### 🌐 Social Media

X/twitter: https://x.com/WhoDat356801/status/1993976135458095273?s=20

DISCORD POST LINK : https://discord.com/channels/879548962464493619/1443540238533263381