Skip to content

aimogmog/klavis

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Source, easy to use MCPs on Slack, Discord and Web 🚀

License: MIT Website Discord YouTube Demo

📚 TL;DR

Klavis AI is building open source, easy to use MCPs on Slack, Discord and Web. We provide:

  • 💬 Slack & Discord & Web Clients: Run MCPs directly from your favorite messaging platforms
  • ☁️ Hosted MCP Servers: Access powerful tools without infrastructure management
  • 🎛️ Simple Web UI: Configure and manage everything with no coding required

Whether you're a non-technical user wanting to leverage AI workflows or a developer looking to build and scale MCPs, Klavis makes it simple.

🎬 Watch Our Demo

See how easy it is to use MCPs (like our Report Generator, YouTube tools, and Document Converters) directly from Slack/Discord:

Klavis AI Demo

You can find more case study videos on our website.

🚀 Quick Start

For detailed MCP client setup instructions, please refer to the platform-specific documentation:

For detailed MCP server setup instructions, please refer to the README file under each server folder.

🏗️ Architecture

Klavis consists of two main components:

MCP Servers

Located in the mcp_servers/ directory, these service-specific modules expose capabilities as tools:

  • Report Generation: Create professional reports from various data sources
  • YouTube: Download, analyze, and transform YouTube content
  • Document Conversion: Convert between various file formats using Pandoc
  • GitHub: Perform GitHub repository operations
  • Slack: For Slack API integration
  • Supabase: For database operations
  • Firecrawl: For web crawling and data collection
  • Resend: For email services
  • Postgres: For PostgreSQL database operations
  • Discord: For Discord API integration

MCP Clients

Located in the mcp-clients/ directory, these client applications connect to MCP servers and interface with end-user platforms:

  • Discord Bot: Interactive AI assistant for Discord
  • Slack Bot: Interactive AI assistant for Slack
  • Base Client: Shared functionality for all platform clients

🧩 Extending Klavis

Adding a New Tool

  1. Create a new directory in mcp_servers/
  2. Implement the MCP server interface
  3. Register your tools with appropriate schemas
  4. Connect to your client through the standard SSE protocol

Adding a New Client Platform

  1. Create a new client module in mcp-clients/
  2. Extend the base_bot.py functionality
  3. Implement platform-specific message handling
  4. Connect to MCP servers using mcp_client.py

🤝 Contributing

We love contributions! Join our Discord community to discuss ideas and get help.

📚 Citation

If you use Klavis in your research or project, please cite:

@software{klavis2025,
  author = {Klavis AI},
  title = {Klavis: Open-Source MCPs on Slack, Discord and Web},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/klavis-ai/klavis}
}

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Thanks for checking out Klavis AI! We're excited to hear your thoughts and build this with the community.

About

Klavis AI (YC X25): Open Source, easy to use MCPs on Slack, Discord and Web

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 40.4%
  • Go 31.9%
  • Python 23.6%
  • JavaScript 3.2%
  • Dockerfile 0.9%