|
|
--- |
|
|
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 |
|
|
|
