MCP Server Beginner App

🚀 多ユーザーMCPサーバー（チャットボットとエージェント付き）

このアプリケーションは、モデルコンテキストプロトコル（MCP）を実装し、2種類のAIアシスタント体験を提供するフルスタックWebアプリケーションです。ユーザー認証、チャット履歴の保存、リアルタイムメッセージング、ドキュメント分析のためのファイルアップロードなどの機能が備わっており、Herokuにデプロイ可能です。

🚀 クイックスタート

このアプリケーションは、モデルコンテキストプロトコル（MCP）を実装し、2種類のAIアシスタント体験を提供します。

• チャットボット：対話形式の質問応答
• エージェント：ツール使用のAIエージェント

ユーザー認証、チャット履歴の保存、リアルタイムWebSocketメッセージング、ドキュメント分析のためのファイルアップロードなどの機能があり、Herokuにデプロイ可能です。

✨ 主な機能

• ユーザー認証：登録、ログイン、パスワード回復、メール認証
• 双AIインターフェース：チャットボットとエージェント、それぞれ独自の機能を持つ
• リアルタイムチャット：WebSocketベースの即時メッセージング
• チャット履歴：永続的な、ユーザー固有のチャットログ
• ファイルアップロード：チャット内でドキュメントを分析
• MCPサーバー統合：複数のMCPサーバーに接続してツールを実行
• レスポンシブUI：クリーンでモバイルデバイスに適したHTML/CSS/JSのフロントエンド
• Herokuデプロイ可能：クラウドデプロイに対応

🔧 技術詳細

技術スタック

• バックエンド：Python 3.10+、FastAPI、MongoDB、Uvicorn
• フロントエンド：HTML、CSS、純粋なJavaScript（static/ を参照）
• AI統合：OpenAI APIまたは互換性のあるLLMプロバイダー
• リアルタイム通信：WebSocket
• デプロイ：Heroku（Procfile付き）

プロジェクト構造

.
├── main.py                # FastAPIアプリケーションのエントリーポイント
├── routes/                # APIルートハンドラー（認証、チャットボット、エージェント、フィードバック）
├── static/                # すべてのページのフロントエンドHTML、CSS、JS
│   ├── chatbot/           # チャットボットのフロントエンドインターフェース
│   ├── agent/             # エージェントのフロントエンドインターフェース
│   └── common/           # 共通のフロントエンドリソース
├── config.py             # アプリケーションの設定ファイル
└── README.md              # プロジェクトドキュメント

📦 インストール

1. リポジトリをクローンする：

   git clone https://github.com/yourusername/multi-user-mcp.git
   cd multi-user-mcp
   

2. 依存関係をインストールする：

   pip install fastapi uvicorn motor python-multipart
   

3. アプリケーションを実行する：

   uvicorn main:app --reload
   

🎯 目標

このプロジェクトは、最新のWeb技術と人工知能を使用して、多ユーザーAIエージェントとチャットボットサーバーを構築する方法を示すことを目的としています。FastAPIを使用して効率的なAPIを提供し、WebSocketを使用してリアルタイム通信を実現し、MongoDBを使用してデータを保存します。

💻 使用例

基本的な使用法

1. ホームページにアクセスする：http://localhost:8000
2. 新しいユーザーを登録する：フォームに入力して送信します。
3. ログインする：登録したメールアドレスとパスワードを使用してログインします。
4. チャットボットと対話する：チャット画面に質問やコマンドを入力します。
5. エージェント機能を使用する：エージェント画面を通じて複雑なタスクを実行します。

🛡️ セキュリティに関する注意事項

• すべてのAPIリクエストは認証と承認を経ています。
• 本番環境ではHTTPSを使用してデータを安全にしてください。
• セキュリティホールを防ぐために、定期的に依存関係を更新してください。

🤝 コントリビューションガイド

ご協力を歓迎します！開発への参加方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細については、LICENSE を参照してください。

📚 参考資料

• FastAPI公式ドキュメント
• MongoDB公式ドキュメント
• OpenAI APIドキュメント
• Heroku開発ガイド

連絡先

何か質問やフィードバックがある場合は、以下の方法で連絡してください。

• メール：contact@yourdomain.com
• GitHub：あなたのGitHubリンク