Commit
Β·
feeeb29
1
Parent(s):
aa45871
fix: Update app.py with gr.Group() fix and latest features
Browse files- Replace deprecated gr.Box() with gr.Group() for Gradio 4.31.0 compatibility
- Add Claude Desktop integration features
- Update documentation with video placeholder
- Ensure all demo features work correctly
- README.md +40 -7
- app.py +1 -1
- requirements.txt +17 -4
README.md
CHANGED
|
@@ -13,6 +13,7 @@ tags:
|
|
| 13 |
- agents
|
| 14 |
- gradio
|
| 15 |
- hackathon
|
|
|
|
| 16 |
short_description: Open-source MCP tools without expensive LLM subscriptions!
|
| 17 |
---
|
| 18 |
|
|
@@ -20,14 +21,14 @@ short_description: Open-source MCP tools without expensive LLM subscriptions!
|
|
| 20 |
|
| 21 |
<div align="center">
|
| 22 |
|
| 23 |
-
[](https://huggingface.co/spaces/
|
| 24 |
-
[](https://github.com/
|
| 25 |
[](LICENSE)
|
| 26 |
[](https://huggingface.co/hackathon)
|
| 27 |
|
| 28 |
**Open-source access to MCP tools without expensive LLM subscriptions**
|
| 29 |
|
| 30 |
-
[Try Demo](https://huggingface.co/spaces/
|
| 31 |
|
| 32 |
</div>
|
| 33 |
|
|
@@ -41,6 +42,10 @@ We believe everyone should be able to:
|
|
| 41 |
- **π Build and deploy tools** using Gradio's intuitive interface
|
| 42 |
- **π€ Contribute to the open-source ecosystem** regardless of budget
|
| 43 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 44 |
## β¨ What is Gradio MCP Playground?
|
| 45 |
|
| 46 |
A comprehensive platform for building, managing, and deploying Model Context Protocol (MCP) servers using Gradio. This playground democratizes access to MCP technology, allowing developers and enthusiasts to "play" with MCP servers, agents, and LLM-tool integrations while showcasing the powerful features of Gradio.
|
|
@@ -52,6 +57,7 @@ A comprehensive platform for building, managing, and deploying Model Context Pro
|
|
| 52 |
- **π¨ Visual Development** - Build complex agents through an intuitive UI
|
| 53 |
- **π Learning Platform** - Understand MCP concepts through interactive examples
|
| 54 |
- **π Community Driven** - Share and discover agents built by others
|
|
|
|
| 55 |
|
| 56 |
## π Features Overview
|
| 57 |
|
|
@@ -79,9 +85,12 @@ Create MCP servers without extensive coding:
|
|
| 79 |
Professional-grade server lifecycle management:
|
| 80 |
|
| 81 |
- **Active Servers** - Monitor running MCP servers in real-time
|
|
|
|
|
|
|
| 82 |
- **Server Registry** - Browse and install community servers
|
| 83 |
- **Quick Deploy** - One-click deployment to Hugging Face Spaces
|
| 84 |
- **Performance Monitoring** - Track server health and usage
|
|
|
|
| 85 |
|
| 86 |
### π MCP Connections
|
| 87 |
Connect to any MCP server with ease:
|
|
@@ -121,7 +130,7 @@ This Hugging Face Space provides a **demo version** showcasing all features. Som
|
|
| 121 |
|
| 122 |
```bash
|
| 123 |
# Clone the repository
|
| 124 |
-
git clone https://github.com/
|
| 125 |
cd gradio-mcp-playground
|
| 126 |
|
| 127 |
# Install with all dependencies
|
|
@@ -185,6 +194,30 @@ gmp deploy my-server # Deploy to Hugging Face Spaces
|
|
| 185 |
- **Team Collaboration** - Share tools internally
|
| 186 |
- **Cost-Effective Development** - Prototype without API costs
|
| 187 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 188 |
## π οΈ Creating MCP Servers
|
| 189 |
|
| 190 |
### Basic Example
|
|
@@ -301,9 +334,9 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
|
| 301 |
|
| 302 |
## π Support & Contact
|
| 303 |
|
| 304 |
-
- **GitHub Issues**: [Report bugs or request features](https://github.com/
|
| 305 |
-
- **Discussions**: [Join the conversation](https://huggingface.co/spaces/
|
| 306 |
-
- **Documentation**: [Full docs on GitHub](https://github.com/
|
| 307 |
|
| 308 |
---
|
| 309 |
|
|
|
|
| 13 |
- agents
|
| 14 |
- gradio
|
| 15 |
- hackathon
|
| 16 |
+
- agent-demo-track
|
| 17 |
short_description: Open-source MCP tools without expensive LLM subscriptions!
|
| 18 |
---
|
| 19 |
|
|
|
|
| 21 |
|
| 22 |
<div align="center">
|
| 23 |
|
| 24 |
+
[](https://huggingface.co/spaces/Agents-MCP-Hackathon/gradio-mcp-playground)
|
| 25 |
+
[](https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground)
|
| 26 |
[](LICENSE)
|
| 27 |
[](https://huggingface.co/hackathon)
|
| 28 |
|
| 29 |
**Open-source access to MCP tools without expensive LLM subscriptions**
|
| 30 |
|
| 31 |
+
[Try Demo](https://huggingface.co/spaces/Agents-MCP-Hackathon/gradio-mcp-playground) | [Documentation](https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground) | [Report Bug](https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground/issues)
|
| 32 |
|
| 33 |
</div>
|
| 34 |
|
|
|
|
| 42 |
- **π Build and deploy tools** using Gradio's intuitive interface
|
| 43 |
- **π€ Contribute to the open-source ecosystem** regardless of budget
|
| 44 |
|
| 45 |
+
## π₯ Video Overview
|
| 46 |
+
|
| 47 |
+
[Watch the video demo](YOUR_VIDEO_LINK_HERE) - Learn how Gradio MCP Playground democratizes access to MCP technology and see the powerful agentic capabilities in action!
|
| 48 |
+
|
| 49 |
## β¨ What is Gradio MCP Playground?
|
| 50 |
|
| 51 |
A comprehensive platform for building, managing, and deploying Model Context Protocol (MCP) servers using Gradio. This playground democratizes access to MCP technology, allowing developers and enthusiasts to "play" with MCP servers, agents, and LLM-tool integrations while showcasing the powerful features of Gradio.
|
|
|
|
| 57 |
- **π¨ Visual Development** - Build complex agents through an intuitive UI
|
| 58 |
- **π Learning Platform** - Understand MCP concepts through interactive examples
|
| 59 |
- **π Community Driven** - Share and discover agents built by others
|
| 60 |
+
- **π Claude Desktop Integration** - Automatically imports your existing MCP servers
|
| 61 |
|
| 62 |
## π Features Overview
|
| 63 |
|
|
|
|
| 85 |
Professional-grade server lifecycle management:
|
| 86 |
|
| 87 |
- **Active Servers** - Monitor running MCP servers in real-time
|
| 88 |
+
- **Claude Desktop Integration** - Auto-imports servers from Claude Desktop
|
| 89 |
+
- **Unified Dashboard** - See Gradio and Claude Desktop servers together
|
| 90 |
- **Server Registry** - Browse and install community servers
|
| 91 |
- **Quick Deploy** - One-click deployment to Hugging Face Spaces
|
| 92 |
- **Performance Monitoring** - Track server health and usage
|
| 93 |
+
- **Real-time Status** - Live updates from Claude Desktop server logs
|
| 94 |
|
| 95 |
### π MCP Connections
|
| 96 |
Connect to any MCP server with ease:
|
|
|
|
| 130 |
|
| 131 |
```bash
|
| 132 |
# Clone the repository
|
| 133 |
+
git clone https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground
|
| 134 |
cd gradio-mcp-playground
|
| 135 |
|
| 136 |
# Install with all dependencies
|
|
|
|
| 194 |
- **Team Collaboration** - Share tools internally
|
| 195 |
- **Cost-Effective Development** - Prototype without API costs
|
| 196 |
|
| 197 |
+
## π Claude Desktop Integration
|
| 198 |
+
|
| 199 |
+
The full version seamlessly integrates with Claude Desktop:
|
| 200 |
+
|
| 201 |
+
### Automatic Server Import
|
| 202 |
+
|
| 203 |
+
When you install locally, Gradio MCP Playground automatically:
|
| 204 |
+
- Detects your Claude Desktop installation
|
| 205 |
+
- Imports all configured MCP servers
|
| 206 |
+
- Shows real-time server status
|
| 207 |
+
- Monitors server health from logs
|
| 208 |
+
|
| 209 |
+
### Supported Platforms
|
| 210 |
+
- **Windows**: Auto-detects from `%APPDATA%/Roaming/Claude/`
|
| 211 |
+
- **WSL/Linux**: Finds config at `/mnt/c/Users/{username}/AppData/Roaming/Claude/`
|
| 212 |
+
- **Cross-platform**: Works seamlessly across environments
|
| 213 |
+
|
| 214 |
+
### Benefits
|
| 215 |
+
- No manual configuration needed
|
| 216 |
+
- Unified dashboard for all servers
|
| 217 |
+
- Real-time health monitoring
|
| 218 |
+
- Secure handling of API keys
|
| 219 |
+
- Compatible with all Claude Desktop servers
|
| 220 |
+
|
| 221 |
## π οΈ Creating MCP Servers
|
| 222 |
|
| 223 |
### Basic Example
|
|
|
|
| 334 |
|
| 335 |
## π Support & Contact
|
| 336 |
|
| 337 |
+
- **GitHub Issues**: [Report bugs or request features](https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground/issues)
|
| 338 |
+
- **Discussions**: [Join the conversation](https://huggingface.co/spaces/Agents-MCP-Hackathon/gradio-mcp-playground/discussions)
|
| 339 |
+
- **Documentation**: [Full docs on GitHub](https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground)
|
| 340 |
|
| 341 |
---
|
| 342 |
|
app.py
CHANGED
|
@@ -337,7 +337,7 @@ while True:
|
|
| 337 |
gr.Markdown("#### Available Templates")
|
| 338 |
|
| 339 |
for template in self.templates:
|
| 340 |
-
with gr.
|
| 341 |
gr.Markdown(f"**{template['name']}**")
|
| 342 |
gr.Markdown(f"*{template['description']}*")
|
| 343 |
gr.Code(
|
|
|
|
| 337 |
gr.Markdown("#### Available Templates")
|
| 338 |
|
| 339 |
for template in self.templates:
|
| 340 |
+
with gr.Group():
|
| 341 |
gr.Markdown(f"**{template['name']}**")
|
| 342 |
gr.Markdown(f"*{template['description']}*")
|
| 343 |
gr.Code(
|
requirements.txt
CHANGED
|
@@ -1,5 +1,18 @@
|
|
| 1 |
-
#
|
| 2 |
-
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
pydantic>=2.0.0
|
| 5 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Hugging Face Space Requirements
|
| 2 |
+
|
| 3 |
+
# Core Gradio dependency
|
| 4 |
+
gradio>=4.44.0
|
| 5 |
+
|
| 6 |
+
# Essential dependencies for the demo
|
| 7 |
+
click>=8.0.0
|
| 8 |
pydantic>=2.0.0
|
| 9 |
+
requests>=2.28.0
|
| 10 |
+
pyyaml>=6.0
|
| 11 |
+
rich>=13.0.0
|
| 12 |
+
|
| 13 |
+
# Optional MCP support (graceful fallback if not available)
|
| 14 |
+
mcp>=1.0.0
|
| 15 |
+
|
| 16 |
+
# For the demo interface and utilities
|
| 17 |
+
python-dotenv>=1.0.0
|
| 18 |
+
pathlib
|