MCP Chat Bot

🚀 AI-based Chat System with Multiple MCP Servers

The AI-based chat system with multiple MCP servers enables seamless integration of host applications with various AI servers, providing enhanced information retrieval and analysis capabilities.

✨ Features

MCP is a powerful client-server architecture that allows host applications to seamlessly connect to multiple AI servers. The system offers enhanced capabilities through dedicated MCP servers:

• MCP File System: Allows Claude to search and retrieve information from your specified local folders, making your documents and files accessible to the AI.

• MCP Slack Server: Connects to your Slack workspace, enabling Claude to access and reference chat histories, channels, and shared resources.

• MCP Brave-Search: Provides real-time web search functionality, allowing Claude to find and integrate the latest internet information.

The system intelligently decides which server to use based on your query. Claude automatically analyzes your question and determines whether to search local files, check Slack history, or perform a web search—all without your explicit instructions.

🛠️ General Architecture

At its core, it is a client-server architecture where the host application can connect to multiple servers.

🚀 Quick Start

🤝 Prerequisites

You need to install uv to run this project.

# MacOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

⚙️ Setup

1. Clone the repository.

git clone https://github.com/kira1228/mcp-chat-bot.git
cd mcp-chat-bot

2. Create a .env file and add API keys:

# Create a .env file
touch .env

# Add your API credentials
# ANTHROPIC_API_KEY: For Claude AI integration
echo "ANTHROPIC_API_KEY=<your api key>" >> .env

# SLACK_BOT_TOKEN & SLACK_TEAM_ID: Required for Slack integration
echo "SLACK_BOT_TOKEN=<your api key>" >> .env
echo "SLACK_TEAM_ID=<your api key>" >> .env

# BRAVE_API_KEY: For Brave search functionality
echo "BRAVE_API_KEY=<your api key>" >> .env

3. Create a virtual environment and install dependencies.

# MacOS/Linux
uv venv
source .venv/bin/activate
uv sync

# Windows
uv venv
.venv\Scripts\activate
uv sync

💻 Usage

Run the client with parameters specifying the server.

uv run client.py path/to/dir/you/want/to/use

📚 Documentation

• About MCP
• Open-source MCP Servers
• Claude API
• Brave Search API

📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.