Artifacts MCP Server
🚀 Zero-config MCP server for AI code artifacts with AgentSphere execution
Let AI write code and see results instantly! Supports Python, JavaScript, HTML, React, and more.
✨ Features
- 🎯 Zero Configuration: Just one JSON config, no files to download
- ⚡ Instant Setup: 2-minute installation with uvx
- 🔒 Secure Execution: Code runs in AgentSphere cloud sandboxes
- 🌐 Live Preview: Automatic preview URLs for web applications
- 📦 Multiple Templates: Python, JavaScript, HTML, React, Vue, Streamlit, Gradio
- 🔄 Auto Updates: Always uses the latest version via uvx
🚀 Quick Start
1. Get API Key (2 minutes)
- Visit AgentSphere
- Register and login
- Go to API Key page
- Click CREATE KEY
- Copy your API key (starts with
as_)
2. Configure Your AI Client (30 seconds)
Choose your AI client and copy the JSON config:
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"artifacts": {
"command": "uvx",
"args": ["artifacts-mcp-server"],
"env": {
"AGENTSPHERE_API_KEY": "your_api_key_here"
}
}
}
}
Raycast AI
Edit ~/.config/raycast/ai/mcp_servers.json:
{
"mcpServers": {
"artifacts": {
"command": "uvx",
"args": ["artifacts-mcp-server"],
"env": {
"AGENTSPHERE_API_KEY": "your_api_key_here"
}
}
}
}
Cursor
Edit ~/.cursor/mcp_servers.json:
{
"mcp": {
"servers": {
"artifacts": {
"command": "uvx",
"args": ["artifacts-mcp-server"],
"env": {
"AGENTSPHERE_API_KEY": "your_api_key_here"
}
}
}
}
}
Other Clients
See full client configuration guide in the documentation.
3. Start Using
- Replace
your_api_key_herewith your actual API key - Restart your AI client
- Test: "Create a Python script that prints hello world using artifacts"
Done! 🎉
🎮 Usage Examples
Python Script
Create a Python script that generates the Fibonacci sequence using artifacts
Web Application
Create an HTML calculator page using artifacts
React App
Create a React todo application using artifacts
Data Visualization
Create a Streamlit app that shows stock data charts using artifacts
🛠️ Supported Templates
| Template | Description | Live Preview |
|---|---|---|
python |
Python scripts with console output | ❌ |
javascript |
JavaScript/Node.js scripts | ❌ |
html |
Static HTML pages | ✅ |
react |
React applications | ✅ |
vue |
Vue.js applications | ✅ |
streamlit |
Streamlit data applications | ✅ |
gradio |
Gradio AI applications | ✅ |
✅ = Automatic preview URL with browser auto-open
🔧 How It Works
- uvx downloads and runs the latest version automatically
- AgentSphere provides secure cloud sandboxes for code execution
- FastMCP handles the Model Context Protocol communication
- Zero maintenance - always uses the latest version
🆚 Why UVX?
| Method | Files Needed | Setup Time | Updates |
|---|---|---|---|
| UVX | 0 | 2 minutes | Automatic |
| Manual | 2-4 | 10 minutes | Manual |
📋 Requirements
- UV package manager (auto-installs if missing)
- AgentSphere API key (free tier available)
- MCP-compatible AI client (Claude Desktop, Raycast, Cursor, etc.)
❓ Troubleshooting
"uvx: command not found"
Install UV:
curl -LsSf https://astral.sh/uv/install.sh | sh
First run is slow
uvx downloads dependencies on first run (1-2 minutes). Subsequent runs are instant.
API Key errors
Ensure your API key:
- Starts with
as_ - Is completely copied without extra spaces
- Is properly formatted in JSON
🤝 Supported Clients
- ✅ Claude Desktop - Free, full-featured
- ✅ Raycast AI - macOS, requires Pro
- ✅ Cursor - AI code editor
- ✅ Zed Editor - High-performance
- ✅ VS Code + Cline - Popular combination
- ✅ Continue.dev - VS Code extension
📖 Documentation
- AgentSphere: https://docs.agentsphere.run/
- Model Context Protocol: https://modelcontextprotocol.io/
- FastMCP: https://gofastmcp.com/
📄 License
MIT License - see LICENSE file for details.
🙏 Acknowledgments
- Anthropic for the Model Context Protocol
- AgentSphere for secure code execution
- Astral for the amazing UV package manager
Metadata
Release files for artifacts-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| artifacts_mcp_server-0.1.0.tar.gz | 28.3 kB | Without provenance | Details for artifacts_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| artifacts_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for artifacts_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 36.8 kB
Release files / artifacts_mcp_server-0.1.0.tar.gz
| Download URL | artifacts_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 28.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2e09c120fa956269549c8cb4e4b6797ab95e1424c58dcbc00822ba86c1f05bed
|
|
BLAKE2b-256 checksum How to use checksums |
c32b33f73535bd157231d579aec5b14e7c5ad82e95e7d0bb0a941099be51ce9e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.4
|
Release files / artifacts_mcp_server-0.1.0-py3-none-any.whl
| Download URL | artifacts_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 8.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1aca4fed1f3614a7ff149586f68f7d3517241a8b43a43377ccc1300ca515eab0
|
|
BLAKE2b-256 checksum How to use checksums |
38e2468f6bdfef02e4e530370c01cfb40cbb8068155bee6f6878448e17de6bd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.4
|
Security for artifacts-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.