MCP Chat Bot

🚀 AIベースのチャットシステムと複数のMCPサーバー

MCPを用いた、強力なAIベースのチャットシステムで、複数のサーバーを通じて情報検索が可能です。

🚀 クイックスタート

このシステムは、MCP という強力なクライアント - サーバーアーキテクチャを利用しており、ホストアプリケーションが複数のAIサーバーにシームレスに接続できるようになっています。専用のMCPサーバーを通じて、以下のような強化機能を提供します。

• MCPファイルシステム：Claudeが指定したローカルフォルダ内の情報を検索・取得できるようにし、ドキュメントやファイルをAIが利用できるようにします。
• MCP Slackサーバー：Slackワークスペースに接続し、Claudeがチャット履歴、チャンネル、共有リソースにアクセスし参照できるようにします。
• MCP Brave-Search：リアルタイムのウェブ検索機能を提供し、Claudeが最新のインターネット情報を検索し統合できるようにします。

システムはクエリに応じて自動的に最適なサーバーを選択します。Claudeは自動的に質問を分析し、ローカルファイルの検索、Slack履歴の確認、またはウェブ検索を行うかを判断し、ユーザーからの明示的な指示を必要としません。

🛠️ 一般的なアーキテクチャ

このシステムの中核はクライアント - サーバーアーキテクチャで、ホストアプリケーションが複数のサーバーに接続できます。

📦 インストール

🤝 前提条件

このプロジェクトを実行するにはuvをインストールする必要があります。

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

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

⚙️ 設定

1. リポジトリをクローンします。

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

2. .envファイルを作成し、APIキーを追加します。

# .envファイルを作成
touch .env

# API認証情報を追加
# ANTHROPIC_API_KEY：Claude AIの統合に使用
echo "ANTHROPIC_API_KEY=<your api key>" >> .env

# SLACK_BOT_TOKEN & SLACK_TEAM_ID：Slackの統合に必要
echo "SLACK_BOT_TOKEN=<your api key>" >> .env
echo "SLACK_TEAM_ID=<your api key>" >> .env

# BRAVE_API_KEY：Brave検索機能に使用
echo "BRAVE_API_KEY=<your api key>" >> .env

3. 仮想環境を作成し、依存関係をインストールします。

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

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

💻 使用例

基本的な使用法

引数を指定してクライアントを実行します。

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

📚 ドキュメント

• MCPについて
• オープンソースのMCPサーバー
• Claude API
• Brave検索API

📄 ライセンス

このMCPサーバーはMITライセンスの下で提供されています。これは、MITライセンスの条項と条件に従い、ソフトウェアを自由に使用、修正、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。