Klavis

🚀 Open-source and User-friendly MCP for Slack, Discord, and Web

Klavis AI is dedicated to building an open-source and user-friendly MCP for Slack, Discord, and the Web. Our offerings include:

• 💬 Slack, Discord, and Web Clients: Run MCP directly from your favorite instant messaging platforms.
• ☁️ Hosted MCP Server: Enjoy powerful features without local deployment.
• 📱 Base Client: Core functionality supporting all platforms.

🚀 Quick Start

Slack Bot

# Interact with Klavis on Slack
$ slack_bot.py

Discord Bot

# Experience the intelligent assistant on Discord
$ discord_bot.py

Hosted MCP Server

# Deploy your custom MCP service
$ python mcp_server.py

✨ Features

MCP Server (Bot Component)

• OpenAI Integration: Supports interaction with the OpenAI API.
• Pinecone Integration: Integrates vector database technology.
• LangChain Integration: Implements complex workflow processing.
• Local Adapter: Allows local operation of custom models.

MCP Client (Bot Client)

• Slack Bot: Provides an intelligent interaction experience in the Slack environment.
• Discord Bot: An advanced assistant designed specifically for Discord.
• Base Client: A core functional module common to all platforms.

📦 Installation

Adding New Tools

1. Create a new directory in mcp_servers/.
2. Implement the MCP server interface.
3. Register the tool using the appropriate architecture.
4. Connect to the client via the standard SSE protocol.

Adding a New Platform Client

1. Add a new client module in mcp-clients/.
2. Extend the functionality of base_bot.py.
3. Implement the message processing logic for the specific platform.
4. Connect to the MCP server using mcp_client.py.

🤝 Contribution Guidelines

Community contributions are welcome! Please refer to CONTRIBUTING.md to learn how to submit changes. Join our Discord community to discuss ideas and seek help.

📚 Documentation

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

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

📄 License

This project is open-source under the MIT License. Please see the LICENSE file for details.