Spaces:
Sleeping
Sleeping
Commit
ยท
f2e427f
1
Parent(s):
9dc9aa6
Update HF Space README to acknowledge Ranadeep Laskar and emphasize democratizing MCP access
Browse files
README.md
CHANGED
@@ -13,7 +13,7 @@ tags:
|
|
13 |
- agents
|
14 |
- gradio
|
15 |
- hackathon
|
16 |
-
short_description:
|
17 |
---
|
18 |
|
19 |
# ๐ Gradio MCP Playground
|
@@ -22,178 +22,293 @@ short_description: Build AI agents visually - No code required!
|
|
22 |
|
23 |
[](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground)
|
24 |
[](https://github.com/seanpoyner/gradio-mcp-playground)
|
25 |
-
[](https://huggingface.co/hackathon)
|
27 |
|
28 |
-
**
|
29 |
|
30 |
[Try Demo](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground) | [Documentation](https://github.com/seanpoyner/gradio-mcp-playground/wiki) | [Report Bug](https://github.com/seanpoyner/gradio-mcp-playground/issues)
|
31 |
|
32 |
</div>
|
33 |
|
34 |
-
##
|
35 |
|
36 |
-
This project
|
37 |
|
38 |
-
|
|
|
|
|
|
|
|
|
39 |
|
40 |
-
|
41 |
-
- **๐จ Visual Builder** - No coding required with our drag-and-drop interface
|
42 |
-
- **๐ค AI-Powered Assistance** - Three specialized AI modes to guide you
|
43 |
-
- **๐ Live MCP Integration** - Connect and test real MCP servers instantly
|
44 |
-
- **๐ฆ One-Click Deploy** - Deploy to production with a single button
|
45 |
|
46 |
-
|
47 |
|
48 |
-
|
49 |
|
50 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
51 |
|
52 |
### ๐ AI Assistant Hub
|
53 |
-
Three specialized AI assistants
|
|
|
|
|
|
|
|
|
54 |
|
55 |
-
|
56 |
-
|
57 |
-
- **Arthur (Agent Builder)** - Architect for complex agent systems
|
58 |
|
59 |
-
|
60 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
61 |
|
62 |
-
|
63 |
-
-
|
64 |
-
|
65 |
-
- **
|
|
|
|
|
|
|
66 |
|
67 |
### ๐ MCP Connections
|
68 |
Connect to any MCP server with ease:
|
69 |
|
70 |
-
- **Quick Connect** -
|
71 |
-
-
|
72 |
-
-
|
73 |
-
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
74 |
|
75 |
-
|
76 |
-
|
|
|
|
|
77 |
|
78 |
-
|
79 |
-
|
80 |
-
|
81 |
-
- **
|
|
|
|
|
|
|
82 |
|
83 |
## ๐ Quick Start
|
84 |
|
85 |
-
### Try the Demo (
|
86 |
|
87 |
-
|
88 |
|
89 |
### Local Installation (Full Features)
|
90 |
|
91 |
```bash
|
92 |
-
# Clone repository
|
93 |
git clone https://github.com/seanpoyner/gradio-mcp-playground
|
94 |
cd gradio-mcp-playground
|
95 |
|
96 |
-
# Install dependencies
|
97 |
pip install -e ".[all]"
|
98 |
|
99 |
-
#
|
100 |
gmp dashboard
|
101 |
|
102 |
-
# Or
|
103 |
gmp dashboard --port 8081
|
104 |
```
|
105 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
106 |
## ๐ก Use Cases
|
107 |
|
108 |
### For Developers
|
109 |
-
- **Rapid Prototyping** - Test
|
110 |
-
- **API Integration** - Wrap any API as an MCP server
|
111 |
- **Tool Development** - Create reusable tools for AI assistants
|
|
|
|
|
112 |
|
113 |
-
### For
|
114 |
-
- **
|
115 |
-
- **
|
116 |
-
- **
|
117 |
-
|
118 |
-
### For Educators
|
119 |
-
- **Teaching AI Concepts** - Visual way to explain agent architectures
|
120 |
-
- **Student Projects** - Let students build without infrastructure worries
|
121 |
-
- **Interactive Demos** - Show real AI capabilities in action
|
122 |
-
|
123 |
-
### For Researchers
|
124 |
-
- **Protocol Testing** - Experiment with MCP implementations
|
125 |
-
- **Tool Benchmarking** - Compare different approaches
|
126 |
-
- **Rapid Experimentation** - Test hypotheses quickly
|
127 |
|
128 |
-
|
|
|
|
|
|
|
|
|
129 |
|
130 |
-
|
131 |
-
|
132 |
-
|
133 |
-
|
|
|
134 |
|
135 |
-
## ๐ ๏ธ
|
136 |
|
137 |
-
###
|
138 |
-
- **Frontend**: Gradio 4.31.0 with custom themes
|
139 |
-
- **Backend**: Python with async support
|
140 |
-
- **Protocol**: Model Context Protocol (MCP)
|
141 |
-
- **Deployment**: Hugging Face Spaces compatible
|
142 |
|
143 |
-
|
144 |
-
|
145 |
-
- **MCP** - Standardized protocol for AI tools
|
146 |
-
- **AsyncIO** - High-performance async operations
|
147 |
-
- **Pydantic** - Data validation and serialization
|
148 |
|
149 |
-
|
|
|
|
|
150 |
|
151 |
-
|
|
|
152 |
|
153 |
-
|
154 |
-
|
155 |
-
|
156 |
-
4. **Community** - Share and discover agents easily
|
157 |
|
158 |
-
|
159 |
|
160 |
-
|
|
|
161 |
|
162 |
-
|
|
|
|
|
163 |
|
164 |
-
|
165 |
-
|
166 |
-
|
|
|
167 |
|
168 |
-
#
|
169 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
170 |
|
171 |
-
#
|
172 |
-
|
173 |
-
ruff check .
|
174 |
```
|
175 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
176 |
## ๐ License
|
177 |
|
178 |
-
This project is licensed under the
|
179 |
|
180 |
## ๐ Acknowledgments
|
181 |
|
182 |
-
|
183 |
-
- **
|
184 |
-
- **
|
185 |
-
- **
|
|
|
|
|
|
|
|
|
|
|
|
|
186 |
|
187 |
-
## ๐
|
188 |
|
189 |
- **GitHub Issues**: [Report bugs or request features](https://github.com/seanpoyner/gradio-mcp-playground/issues)
|
190 |
- **Discussions**: [Join the conversation](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground/discussions)
|
191 |
-
- **
|
192 |
|
193 |
---
|
194 |
|
195 |
<div align="center">
|
196 |
-
<b>Made with โค๏ธ
|
197 |
<br>
|
198 |
-
<i>
|
199 |
</div>
|
|
|
13 |
- agents
|
14 |
- gradio
|
15 |
- hackathon
|
16 |
+
short_description: Open-source MCP tools without expensive LLM subscriptions!
|
17 |
---
|
18 |
|
19 |
# ๐ Gradio MCP Playground
|
|
|
22 |
|
23 |
[](https://huggingface.co/spaces/seanpoyner/gradio-mcp-playground)
|
24 |
[](https://github.com/seanpoyner/gradio-mcp-playground)
|
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/seanpoyner/gradio-mcp-playground) | [Documentation](https://github.com/seanpoyner/gradio-mcp-playground/wiki) | [Report Bug](https://github.com/seanpoyner/gradio-mcp-playground/issues)
|
31 |
|
32 |
</div>
|
33 |
|
34 |
+
## ๐ฏ Our Mission
|
35 |
|
36 |
+
This project was created to solve a critical problem: **Most MCP tools require expensive LLM API subscriptions**, limiting access for developers, students, and enthusiasts.
|
37 |
|
38 |
+
We believe everyone should be able to:
|
39 |
+
- **๐ Experiment with MCP servers** without financial barriers
|
40 |
+
- **๐ฉโ๐ป Learn AI agent development** through hands-on experience
|
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.
|
47 |
|
48 |
+
### Key Benefits
|
49 |
|
50 |
+
- **๐ฐ No API Keys Required** - Use the demo features without any LLM subscriptions
|
51 |
+
- **๐ Zero to Agent in Minutes** - Create functional MCP servers quickly
|
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 |
|
58 |
### ๐ AI Assistant Hub
|
59 |
+
Three specialized AI assistants to guide your journey:
|
60 |
+
|
61 |
+
- **Adam (General Assistant)** - Your friendly companion with access to MCP tools like screenshots, web search, and file operations
|
62 |
+
- **Liam (MCP Specialist)** - Expert in MCP development, server creation, and pipeline building
|
63 |
+
- **Arthur (Agent Builder)** - Architect for sophisticated autonomous agents and custom implementations
|
64 |
|
65 |
+
### ๐ง Server Builder
|
66 |
+
Create MCP servers without extensive coding:
|
|
|
67 |
|
68 |
+
- **Quick Create** - Build servers from templates in seconds
|
69 |
+
- **Pipeline Builder** - Visual drag-and-drop interface for complex workflows
|
70 |
+
- **Templates Gallery** - Pre-built templates for common use cases:
|
71 |
+
- Calculator (arithmetic operations)
|
72 |
+
- Text Processor (text manipulation)
|
73 |
+
- Image Generator (AI image creation)
|
74 |
+
- Data Analyzer (CSV/data analysis)
|
75 |
+
- Web Scraper (data extraction)
|
76 |
+
- API Wrapper (turn any API into MCP)
|
77 |
|
78 |
+
### ๐ฅ๏ธ Server Management
|
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:
|
88 |
|
89 |
+
- **Quick Connect** - Pre-configured connections to popular servers:
|
90 |
+
- Filesystem (file operations)
|
91 |
+
- Memory (persistent storage)
|
92 |
+
- GitHub (repository management)
|
93 |
+
- Brave Search (web search)
|
94 |
+
- **Custom Connections** - Connect to any MCP server via stdio or SSE
|
95 |
+
- **Tool Discovery** - Automatically discover and test available tools
|
96 |
+
- **Activity Log** - Track all tool executions and results
|
97 |
+
|
98 |
+
### ๐ค Agent Control Panel
|
99 |
+
Build and manage autonomous agents:
|
100 |
|
101 |
+
- **Agent Creation** - Visual interface for building AI agents
|
102 |
+
- **Agent Templates** - Start from proven agent architectures
|
103 |
+
- **Testing Suite** - Real-time testing and debugging
|
104 |
+
- **Deployment Options** - Deploy agents to various platforms
|
105 |
|
106 |
+
### ๐ Help & Resources
|
107 |
+
Comprehensive documentation and support:
|
108 |
+
|
109 |
+
- **Interactive Tutorials** - Step-by-step guides
|
110 |
+
- **API Reference** - Complete documentation
|
111 |
+
- **Video Guides** - Visual learning resources
|
112 |
+
- **Community Forum** - Get help and share knowledge
|
113 |
|
114 |
## ๐ Quick Start
|
115 |
|
116 |
+
### Try the Demo (This Space)
|
117 |
|
118 |
+
This Hugging Face Space provides a **demo version** showcasing all features. Some functionality is limited in the demo - for full features, install locally.
|
119 |
|
120 |
### Local Installation (Full Features)
|
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
|
128 |
pip install -e ".[all]"
|
129 |
|
130 |
+
# Launch the unified dashboard
|
131 |
gmp dashboard
|
132 |
|
133 |
+
# Or start on a custom port
|
134 |
gmp dashboard --port 8081
|
135 |
```
|
136 |
|
137 |
+
### CLI Tools
|
138 |
+
|
139 |
+
Powerful command-line tools for automation:
|
140 |
+
|
141 |
+
```bash
|
142 |
+
# Create servers from templates
|
143 |
+
gmp create calculator my-calc-server
|
144 |
+
gmp create image-generator my-image-server
|
145 |
+
|
146 |
+
# List available templates
|
147 |
+
gmp templates
|
148 |
+
|
149 |
+
# Manage servers
|
150 |
+
gmp server list # List all servers
|
151 |
+
gmp server start my-server # Start a server
|
152 |
+
gmp server stop my-server # Stop a server
|
153 |
+
|
154 |
+
# Connect to MCP servers
|
155 |
+
gmp connect filesystem /path/to/directory
|
156 |
+
gmp connect github --token YOUR_GITHUB_TOKEN
|
157 |
+
|
158 |
+
# Deploy servers
|
159 |
+
gmp deploy my-server # Deploy to Hugging Face Spaces
|
160 |
+
```
|
161 |
+
|
162 |
## ๐ก Use Cases
|
163 |
|
164 |
### For Developers
|
165 |
+
- **Rapid Prototyping** - Test MCP concepts without setup overhead
|
|
|
166 |
- **Tool Development** - Create reusable tools for AI assistants
|
167 |
+
- **API Integration** - Wrap any API as an MCP server
|
168 |
+
- **Learning Platform** - Understand MCP through hands-on examples
|
169 |
|
170 |
+
### For Educators & Students
|
171 |
+
- **Free Learning** - No expensive API keys needed
|
172 |
+
- **Interactive Teaching** - Demonstrate AI concepts visually
|
173 |
+
- **Student Projects** - Build without infrastructure worries
|
174 |
+
- **Research Platform** - Experiment with MCP implementations
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
175 |
|
176 |
+
### For Enthusiasts
|
177 |
+
- **Explore MCP** - Play with cutting-edge AI technology
|
178 |
+
- **Build Tools** - Create useful automation tools
|
179 |
+
- **Share Creations** - Contribute to the community
|
180 |
+
- **Learn by Doing** - Hands-on experience with AI agents
|
181 |
|
182 |
+
### For Businesses
|
183 |
+
- **Proof of Concepts** - Test ideas before investing
|
184 |
+
- **Custom Assistants** - Build domain-specific agents
|
185 |
+
- **Team Collaboration** - Share tools internally
|
186 |
+
- **Cost-Effective Development** - Prototype without API costs
|
187 |
|
188 |
+
## ๐ ๏ธ Creating MCP Servers
|
189 |
|
190 |
+
### Basic Example
|
|
|
|
|
|
|
|
|
191 |
|
192 |
+
```python
|
193 |
+
import gradio as gr
|
|
|
|
|
|
|
194 |
|
195 |
+
def greet(name: str) -> str:
|
196 |
+
"""Greet someone by name."""
|
197 |
+
return f"Hello, {name}!"
|
198 |
|
199 |
+
# Create a Gradio interface
|
200 |
+
demo = gr.Interface(fn=greet, inputs="text", outputs="text")
|
201 |
|
202 |
+
# Launch as an MCP server
|
203 |
+
demo.launch(mcp_server=True)
|
204 |
+
```
|
|
|
205 |
|
206 |
+
### Multi-Tool Server
|
207 |
|
208 |
+
```python
|
209 |
+
import gradio as gr
|
210 |
|
211 |
+
def summarize_text(text: str, max_length: int = 100) -> str:
|
212 |
+
"""Summarize a long text."""
|
213 |
+
return text[:max_length] + "..."
|
214 |
|
215 |
+
def translate_text(text: str, target_language: str = "es") -> str:
|
216 |
+
"""Translate text to another language."""
|
217 |
+
# Translation logic here
|
218 |
+
return f"Translated: {text}"
|
219 |
|
220 |
+
# Create tabbed interface with multiple tools
|
221 |
+
demo = gr.TabbedInterface(
|
222 |
+
[
|
223 |
+
gr.Interface(fn=summarize_text, inputs=["text", "number"], outputs="text"),
|
224 |
+
gr.Interface(fn=translate_text, inputs=["text", "text"], outputs="text")
|
225 |
+
],
|
226 |
+
["Summarizer", "Translator"]
|
227 |
+
)
|
228 |
|
229 |
+
# Launch as MCP server
|
230 |
+
demo.launch(mcp_server=True)
|
|
|
231 |
```
|
232 |
|
233 |
+
## ๐ Architecture & Technology
|
234 |
+
|
235 |
+
### Core Technologies
|
236 |
+
- **Frontend**: Gradio 4.31.0 with custom themes and components
|
237 |
+
- **Backend**: Python with async support for high performance
|
238 |
+
- **Protocol**: Model Context Protocol (MCP) by Anthropic
|
239 |
+
- **Deployment**: Optimized for Hugging Face Spaces
|
240 |
+
|
241 |
+
### Key Components
|
242 |
+
- **Unified Dashboard** - Single interface for all MCP operations
|
243 |
+
- **MCP Client Manager** - Handles connections to multiple servers
|
244 |
+
- **Template Engine** - Generates server code from templates
|
245 |
+
- **Pipeline Builder** - Visual workflow creation
|
246 |
+
- **Agent Framework** - Autonomous agent construction
|
247 |
+
|
248 |
+
### Security & Performance
|
249 |
+
- **Secure Storage** - Encrypted credential management
|
250 |
+
- **Rate Limiting** - Prevent API abuse
|
251 |
+
- **Caching** - Optimized response times
|
252 |
+
- **Error Handling** - Graceful failure recovery
|
253 |
+
|
254 |
+
## ๐ค Project Team & Contributors
|
255 |
+
|
256 |
+
### Core Team
|
257 |
+
- **Sean Poyner** - Project Lead & Creator
|
258 |
+
- **Ranadeep Laskar ([@flickinshots](https://github.com/flickinshots))** - Project Member & Collaborator
|
259 |
+
|
260 |
+
We welcome contributions from the community! See our [Contributing Guide](CONTRIBUTING.md) for details.
|
261 |
+
|
262 |
+
## ๐ Roadmap
|
263 |
+
|
264 |
+
### Current Features (v1.0)
|
265 |
+
- โ
Unified Dashboard
|
266 |
+
- โ
CLI Tools
|
267 |
+
- โ
Template Library
|
268 |
+
- โ
Basic MCP Connections
|
269 |
+
- โ
HF Space Deployment
|
270 |
+
|
271 |
+
### Coming Soon (v1.1)
|
272 |
+
- ๐ Advanced Pipeline Builder
|
273 |
+
- ๐ More Server Templates
|
274 |
+
- ๐ Enhanced Agent Capabilities
|
275 |
+
- ๐ Community Marketplace
|
276 |
+
- ๐ Mobile-Responsive UI
|
277 |
+
|
278 |
+
### Future Vision (v2.0)
|
279 |
+
- ๐ฎ Multi-Agent Orchestration
|
280 |
+
- ๐ฎ Custom Model Integration
|
281 |
+
- ๐ฎ Enterprise Features
|
282 |
+
- ๐ฎ Advanced Analytics
|
283 |
+
- ๐ฎ Plugin System
|
284 |
+
|
285 |
## ๐ License
|
286 |
|
287 |
+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
288 |
|
289 |
## ๐ Acknowledgments
|
290 |
|
291 |
+
### Special Thanks To
|
292 |
+
- **Hugging Face** - For hosting this space and organizing the MCP Hackathon
|
293 |
+
- **Gradio Team** - For the amazing framework that makes this possible
|
294 |
+
- **Anthropic** - For creating the Model Context Protocol
|
295 |
+
- **Open Source Community** - For inspiration and support
|
296 |
+
|
297 |
+
### Built With
|
298 |
+
- [Gradio](https://gradio.app) - The UI framework powering our interface
|
299 |
+
- [Model Context Protocol](https://github.com/anthropics/mcp) - The protocol enabling tool integration
|
300 |
+
- [Python](https://python.org) - Our primary development language
|
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 |
|
310 |
<div align="center">
|
311 |
+
<b>Made with โค๏ธ to democratize MCP technology for everyone</b>
|
312 |
<br>
|
313 |
+
<i>No expensive subscriptions required - just creativity and curiosity!</i>
|
314 |
</div>
|