https://github.com/kiratoyoshihara/mcp-chat-system
AI-powered Chat System with multiple MCP servers.
https://github.com/kiratoyoshihara/mcp-chat-system
Last synced: about 2 months ago
JSON representation
AI-powered Chat System with multiple MCP servers.
- Host: GitHub
- URL: https://github.com/kiratoyoshihara/mcp-chat-system
- Owner: kiratoyoshihara
- License: mit
- Created: 2025-04-06T14:22:41.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-23T14:46:13.000Z (7 months ago)
- Last Synced: 2025-06-09T06:19:09.319Z (5 months ago)
- Language: Python
- Homepage:
- Size: 78.1 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-chat-system** - AI-powered Chat System with multiple MCP servers. `python` `mcp` `server` `ai` `pip install git+https://github.com/kira1228/MCP-RAG-` (AI/ML)
- awesome-mcp-servers - **mcp-chat-system** - AI-powered Chat System with multiple MCP servers. `python` `mcp` `server` `ai` `pip install git+https://github.com/kira1228/MCP-RAG-` (AI/ML)
README
# AI-powered chat system with multiple MCP servers.
## 🌟 Overview
[MCP](https://modelcontextprotocol.io/introduction) is a powerful client-server architecture that enables host applications to connect with multiple AI servers seamlessly. This system offers enhanced capabilities through specialized MCP servers:
- **[MCP Filesystem](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)**:
Allows Claude to search and retrieve information from your specified local folders, making your documents and files accessible to the AI.
- **[MCP Slack Server](https://github.com/modelcontextprotocol/servers/blob/main/src/slack/README.md)**:
Connects to your Slack workspace, enabling Claude to access and reference your conversations,
channels, and shared resources.
- **[MCP Brave-Search](https://github.com/modelcontextprotocol/servers/blob/main/src/brave-search/README.md)**:
Provides real-time web search capabilities, allowing Claude to find and incorporate the latest information from the internet.
The system intelligently determines which server to utilize based on your queries. Claude automatically analyzes your questions and decides whether to search your local files, check Slack history, or perform a web search - all without requiring explicit instructions from you.
## General Architecture 🛠️
At its core, MCP follows a client-server architecture where a host application can connect to multiple servers:
## Getting Started! 🚀
### Prerequisites 🤝
You need to install `uv` to run this project.
```bash
# 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.
```bash
git clone https://github.com/kira1228/mcp-chat-bot.git
cd mcp-chat-bot
```
2. Create a `.env` file with your API keys:
```bash
# Create the .env file
touch .env
# Add your API credentials
# ANTHROPIC_API_KEY: Used for Claude AI integration
echo "ANTHROPIC_API_KEY=" >> .env
# SLACK_BOT_TOKEN & SLACK_TEAM_ID: Required for Slack integration
echo "SLACK_BOT_TOKEN=" >> .env
echo "SLACK_TEAM_ID=" >> .env
# BRAVE_API_KEY: Used for Brave search capabilities
echo "BRAVE_API_KEY=" >> .env
```
3. Create a virtual environment and install the dependencies.
```bash
# MacOS/Linux
uv venv
source .venv/bin/activate
uv sync
# Windows
uv venv
.venv\Scripts\activate
uv sync
```
### Usage 💻
Run the client with arguments for the server.
```bash
uv run client.py path/to/dir/you/want/to/use
```
## References 📚
- [About MCP](https://modelcontextprotocol.io/introduction)
- [Open source MCP servers](https://github.com/modelcontextprotocol/servers)
- [Claude API](https://docs.anthropic.com/en/api/getting-started)
- [Brave search API](https://api-dashboard.search.brave.com/app/documentation/web-search/get-started)
## 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.