Klavis AI - Production-Ready MCP Servers

🌐 Hosted MCP Service | 🐳 Self-Hosted Solutions | 🔐 Enterprise OAuth

🚀 Quick Start - Run Any MCP Server in 30 Seconds

🌐 Using Hosted Service (Recommended for Production)

Get instant access to 50+ MCP servers with our managed infrastructure - no setup required:

🔗 Get Free API Key →

pip install klavis
# or
npm install klavis

from klavis import Klavis

klavis = Klavis(api_key="your-free-key")
server = klavis.mcp_server.create_server_instance("GMAIL", "user123")

🐳 Using Docker (For Self-Hosting)

# Run GitHub MCP Server (no OAuth support)
docker run -p 5000:5000 -e AUTH_DATA='{"access_token":"ghp_your_github_token_here"}' \
  ghcr.io/klavis-ai/github-mcp-server:latest

# Run Gmail MCP Server with OAuth
docker run -p 8000:5000 -e KLAVIS_API_KEY=your_key \
  ghcr.io/klavis-ai/gmail-mcp-server:latest

🖥️ Cursor Configuration

For Cursor, use our hosted service URLs directly - no Docker setup needed:

{
  "mcpServers": {
    "klavis-gmail": {
      "url": "https://gmail-mcp-server.klavis.ai/mcp/?instance_id=your-instance"
    },
    "klavis-github": {
      "url": "https://github-mcp-server.klavis.ai/mcp/?instance_id=your-instance"
    }
  }
}

💡 Get your personalized configuration instantly:

1. 🔗 Visit our MCP Servers page →
2. Select any service (Gmail, GitHub, Slack, etc.)
3. Copy the generated configuration for your tool
4. Paste into Claude Desktop config - done!

✨ Enterprise-Grade MCP Infrastructure

• 🌐 Hosted Service: Production-ready managed infrastructure with 99.9% uptime SLA
• 🔐 Enterprise OAuth: Seamless authentication for Google, GitHub, Slack, Salesforce, etc.
• 🛠️ 50+ Integrations: CRM, productivity tools, databases, social media, and more
• 🚀 Instant Deployment: Zero-config setup for Claude Desktop, VS Code, Cursor
• 🏢 Enterprise Ready: SOC2 compliant, GDPR ready, with dedicated support
• 📖 Open Source: Full source code available for customization and self-hosting

🎯 Self Hosting Instructions

1. 🐳 Docker Images (Fastest Way to Start)

Perfect for trying out MCP servers or integrating with AI tools like Claude Desktop.

Available Images:

• ghcr.io/klavis-ai/{server-name}-mcp-server:latest - Basic server
• ghcr.io/klavis-ai/{server-name}-mcp-server:latest - With OAuth support

🔍 Browse All Docker Images →

# Example: GitHub MCP Server
docker run -p 5000:5000 ghcr.io/klavis-ai/github-mcp-server:latest

# Example: Gmail with OAuth (requires API key)
docker run -it -e KLAVIS_API_KEY=your_key \
  ghcr.io/klavis-ai/gmail-mcp-server:latest

🔗 Get Free API Key →

2. 🏗️ Build from Source

Clone and run any MCP server locally (with or without Docker):

git clone https://github.com/klavis-ai/klavis.git
cd klavis/mcp_servers/github

# Option A: Using Docker
docker build -t github-mcp .
docker run -p 5000:5000 github-mcp

# Option B: Run directly (Go example)
go mod download
go run server.go

# Option C: Python servers  
cd ../youtube
pip install -r requirements.txt
python server.py

# Option D: Node.js servers
cd ../slack  
npm install
npm start

Each server includes detailed setup instructions in its individual README.

Use our managed infrastructure - no Docker required:

pip install klavis  # or npm install klavis

🛠️ Available MCP Servers

Service	Docker Image	OAuth Required	Description
GitHub	ghcr.io/klavis-ai/github-mcp-server	✅	Repository management, issues, PRs
Gmail	ghcr.io/klavis-ai/gmail-mcp-server:latest	✅	Email reading, sending, management
Google Sheets	ghcr.io/klavis-ai/google_sheets-mcp-server:latest	✅	Spreadsheet operations
YouTube	ghcr.io/klavis-ai/youtube-mcp-server	❌	Video information, search
Slack	ghcr.io/klavis-ai/slack-mcp-server:latest	✅	Channel management, messaging
Notion	ghcr.io/klavis-ai/notion-mcp-server:latest	✅	Database and page operations
Salesforce	ghcr.io/klavis-ai/salesforce-mcp-server:latest	✅	CRM data management
Postgres	ghcr.io/klavis-ai/postgres-mcp-server	❌	Database operations
...	...	...	...

And more! 🔍 View All 50+ Servers → | 🐳 Browse Docker Images →

💡 Usage Examples

For existing MCP implementations:

Python

from klavis import Klavis

klavis = Klavis(api_key="your-key")
server = klavis.mcp_server.create_server_instance(
    server_name="YOUTUBE",
    user_id="user123",
    platform_name="MyApp"
)

TypeScript

import { KlavisClient } from 'klavis';

const klavis = new KlavisClient({ apiKey: 'your-key' });
const server = await klavis.mcpServer.createServerInstance({
    serverName: "Gmail",
    userId: "user123"
});

With AI Frameworks

OpenAI Function Calling

from openai import OpenAI
from klavis import Klavis

klavis = Klavis(api_key="your-key")
openai = OpenAI(api_key="your-openai-key")

# Create server and get tools
server = klavis.mcp_server.create_server_instance("YOUTUBE", "user123")
tools = klavis.mcp_server.list_tools(server.server_url, format="OPENAI")

# Use with OpenAI
response = openai.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Summarize this video: https://..."}],
    tools=tools.tools
)

📖 View Complete Examples →

🌐 Hosted MCP Service - Zero Setup Required

Perfect for individuals and businesses who want instant access without infrastructure complexity:

✨ Why Choose Our Hosted Service:

• 🚀 Instant Setup: Get any MCP server running in 30 seconds
• 🔐 OAuth Handled: No complex authentication setup required
• 🏗️ No Infrastructure: Everything runs on our secure, scalable cloud
• 📈 Auto-Scaling: From prototype to production seamlessly
• 🔄 Always Updated: Latest MCP server versions automatically
• 💰 Cost-Effective: Pay only for what you use, free tier available

💻 Quick Integration:

from klavis import Klavis

# Get started with just an API key
klavis = Klavis(api_key="your-free-key")

# Create any MCP server instantly
gmail_server = klavis.mcp_server.create_server_instance(
    server_name="GMAIL",
    user_id="your-user-id", 
    platform_name="MyApp"
)

# Server is ready to use immediately
print(f"Gmail MCP server ready: {gmail_server.server_url}")

🔗 Get Free API Key → | 📖 Complete Documentation →

🔐 OAuth Authentication (For OAuth-Enabled Servers)

Some servers require OAuth authentication (Google, GitHub, Slack, etc.). OAuth implementation requires significant setup and code complexity:

# Run with OAuth support (requires free API key)
docker run -it -e KLAVIS_API_KEY=your_free_key \
  ghcr.io/klavis-ai/gmail-mcp-server:latest

# Follow the displayed URL to authenticate
# Server starts automatically after authentication

Why OAuth needs additional implementation?

• 🔧 Complex Setup: Each service requires creating OAuth apps with specific redirect URLs, scopes, and credentials
• 📝 Implementation Overhead: OAuth 2.0 flow requires callback handling, token refresh, and secure storage
• 🔑 Credential Management: Managing multiple OAuth app secrets across different services
• 🔄 Token Lifecycle: Handling token expiration, refresh, and error cases

Our OAuth wrapper simplifies this by handling all the complex OAuth implementation details, so you can focus on using the MCP servers directly.

Alternative: For advanced users, you can implement OAuth yourself by creating apps with each service provider. Check individual server READMEs for technical details.

📚 Resources & Community

Resource	Link	Description
📖 Documentation	docs.klavis.ai	Complete guides and API reference
💬 Discord	Join Community	Get help and connect with users
🐛 Issues	GitHub Issues	Report bugs and request features
📦 Examples	examples/	Working examples with popular AI frameworks
🔧 Server Guides	mcp_servers/	Individual server documentation

🤝 Contributing

We love contributions! Whether you want to:

• 🐛 Report bugs or request features
• 📝 Improve documentation
• 🔧 Build new MCP servers
• 🎨 Enhance existing servers

Check out our Contributing Guide to get started!

📜 License

MIT License - see LICENSE for details.

---

🚀 Supercharge AI Applications

Get Free API Key • Documentation • Discord • Examples