genvrlabs/remote-mcp-server-authless
If you are the rightful owner of remote-mcp-server-authless and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This document provides a comprehensive overview of setting up a remote Model Context Protocol (MCP) server on Cloudflare Workers without authentication.
🚀 GenVR MCP Server - 300+ AI Models for ChatGPT & Claude
The ultimate MCP server providing access to 300+ AI models including image generation, video creation, audio synthesis, and more through ChatGPT and Claude Desktop.
✨ What is this?
This is a Model Context Protocol (MCP) server that exposes 300+ AI models from GenVR Research through a simple, standardized interface. Use it with:
- 🤖 ChatGPT (via AgentKit)
- 🧠 Claude Desktop
- 🔧 Any MCP-compatible client
🎯 Key Features
- 300+ AI Models across multiple categories
- Zero Authentication - credentials passed in tool parameters
- Cloudflare Workers deployment for global performance
- Full Schema Support - automatic parameter validation
- Real-time Generation - async task polling with status updates
🎨 Available AI Model Categories
| Category | Description | Example Models |
|---|---|---|
| 🖼️ Image Generation | Create stunning images from text prompts | Flux Spro, Hunyuan 3, ImagineArt |
| 🎬 Video Generation | Generate videos from text or images | Runway Gen-3, Pika Labs, Stable Video |
| 🎵 Audio Generation | Create music, speech, and sound effects | MusicLM, Bark, AudioCraft |
| 📝 Text Generation | Advanced language models | GPT-4, Claude, Llama 3 |
| 🔄 Image-to-Image | Transform and edit existing images | ControlNet, IP-Adapter, Inpainting |
| 🎭 Character Animation | Animate characters and avatars | Character-LLM, AnimateDiff |
| 🌍 3D Generation | Create 3D models and environments | Tripo3D, Luma AI, Gaussian Splatting |
🚀 Quick Start
Option 1: One-Click Deploy (Recommended)
This will deploy your MCP server to: https://your-server.your-account.workers.dev/sse
Option 2: Local Development
# Clone the repository
git clone https://github.com/genvrlabs/remote-mcp-server-authless.git
cd remote-mcp-server-authless
# Install dependencies
npm install
# Start development server
npm run dev
# Deploy to Cloudflare Workers
npm run deploy
🔧 ChatGPT Integration
Step 1: Configure ChatGPT AgentKit
- Open ChatGPT and go to Settings → AgentKit
- Click "Add MCP Server"
- Enter your server URL:
https://your-server.your-account.workers.dev/sse
Step 2: Start Creating!
Simply ask ChatGPT to use any of the 300+ AI models:
"Generate an image of a cyberpunk city at night with neon lights using the Flux Spro model"
"Create a video of ocean waves with dramatic lighting using Runway Gen-3"
"Generate a jazz piano piece using MusicLM"
🧠 Claude Desktop Integration
Step 1: Install mcp-remote
npm install -g mcp-remote
Step 2: Configure Claude Desktop
Open Claude Desktop → Settings → Developer → Edit Config and add:
{
"mcpServers": {
"genvr-ai": {
"command": "npx",
"args": [
"mcp-remote",
"https://your-server.your-account.workers.dev/sse"
]
}
}
}
Step 3: Restart Claude
Restart Claude Desktop and you'll see 300+ GenVR tools available!
📋 Usage Examples
Image Generation
// Available tools: generate_imagegen_flux_spro_dev, generate_imagegen_hunyuan3_image, etc.
{
"prompt": "A futuristic cityscape at sunset",
"userId": "your-genvr-user-id",
"accessToken": "your-genvr-access-token"
}
Video Creation
// Available tools: generate_videogen_runway_gen3, generate_videogen_pika_labs, etc.
{
"prompt": "A cat playing with a ball of yarn",
"duration": 5,
"userId": "your-genvr-user-id",
"accessToken": "your-genvr-access-token"
}
Audio Generation
// Available tools: generate_audiogen_musiclm, generate_audiogen_bark, etc.
{
"text": "Generate a relaxing piano melody",
"duration": 30,
"userId": "your-genvr-user-id",
"accessToken": "your-genvr-access-token"
}
🔑 Getting GenVR Credentials
- Visit GenVR Research
- Sign up for an account
- Get your User ID and Access Token from the dashboard
- Use these credentials in your MCP tool calls
🛠️ Development
Project Structure
src/
├── index.ts # Main MCP server implementation
├── curated-models.json # 300+ AI model definitions
├── schemas-cache.json # Parameter schemas for all models
└── index.d.ts # TypeScript definitions
Adding Custom Tools
To add your own tools, modify src/index.ts:
this.server.tool("my_custom_tool",
{
input: z.string().describe("Your input parameter")
},
async ({ input }) => {
// Your tool logic here
return { content: [{ type: "text", text: "Result" }] };
}
);
Available Scripts
npm run dev # Start development server
npm run deploy # Deploy to Cloudflare Workers
npm run format # Format code with Biome
npm run lint:fix # Fix linting issues
npm run type-check # Run TypeScript type checking
🌐 API Endpoints
| Endpoint | Description |
|---|---|
/sse | Server-Sent Events endpoint for MCP clients |
/mcp | Standard MCP protocol endpoint |
🔧 Configuration
Environment Variables
No environment variables required! The server is designed to be stateless and credential-free.
Customization
- Model Selection: Edit
src/curated-models.jsonto include/exclude specific models - Schema Updates: Update
src/schemas-cache.jsonfor parameter changes - Custom Tools: Add your own tools in the
init()method
🚨 Troubleshooting
Common Issues
| Issue | Solution |
|---|---|
| "Tool execution failed" | Check your GenVR credentials are valid |
| "No task ID returned" | Verify the model name and parameters |
| "Task timed out" | Some models take longer - increase timeout in code |
| MCP connection fails | Ensure the server URL is correct and accessible |
Debug Mode
Enable debug logging by setting the environment variable:
DEBUG=true npm run dev
🤝 Contributing
We welcome contributions! Please see our for details.
Development Setup
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes
- Run tests:
npm run type-check - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the file for details.
🙏 Acknowledgments
- GenVR Research for providing the AI models
- Cloudflare Workers for the hosting platform
- Model Context Protocol for the standard
- Anthropic for Claude Desktop integration
📞 Support
- 📧 Email: admin@genvrresearch.com
- 📖 Documentation: GenVR API Docs
- 🐛 Issues: GitHub Issues