seanpoyner commited on
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

Files changed (3) hide show
  1. README.md +40 -7
  2. app.py +1 -1
  3. 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
- [![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground)
24
- [![GitHub](https://img.shields.io/badge/GitHub-Repository-black)](https://github.com/seanpoyner/gradio-mcp-playground)
25
  [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
26
  [![Hackathon](https://img.shields.io/badge/HF%20MCP%20Hackathon-2025-orange)](https://huggingface.co/hackathon)
27
 
28
  **Open-source access to MCP tools without expensive LLM subscriptions**
29
 
30
- [Try Demo](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground) | [Documentation](https://github.com/seanpoyner/gradio-mcp-playground) | [Report Bug](https://github.com/seanpoyner/gradio-mcp-playground/issues)
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/seanpoyner/gradio-mcp-playground
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/seanpoyner/gradio-mcp-playground/issues)
305
- - **Discussions**: [Join the conversation](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground/discussions)
306
- - **Documentation**: [Full docs on GitHub](https://github.com/seanpoyner/gradio-mcp-playground)
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
+ [![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Agents-MCP-Hackathon/gradio-mcp-playground)
25
+ [![GitHub](https://img.shields.io/badge/GitHub-Repository-black)](https://github.com/Agents-MCP-Hackathon/gradio-mcp-playground)
26
  [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
27
  [![Hackathon](https://img.shields.io/badge/HF%20MCP%20Hackathon-2025-orange)](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.Box():
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
- # requirements.txt for HF Space
2
- gradio
3
- huggingface-hub>=0.23.0
 
 
 
 
4
  pydantic>=2.0.0
5
- typing-extensions>=4.5.0
 
 
 
 
 
 
 
 
 
 
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