MCP Chat

🚀 MCP Chat

このプロジェクトは、MCP（Model Context Protocol）サーバーを利用したチャットシステムです。Claude MacアプリやClaude CodeのようなMCPクライアントを使ったチャットルーレット形式のインタラクションを実現することを目指しています。

🚀 クイックスタート

このセクションでは、MCP Chatをすぐに使い始めるための手順を説明します。

サーバーの起動

SHTTPトランスポートを使用してMCPサーバーを起動します。

# ターミナル1
uv sync
uv run fastmcp run mcp_chat/server.py --transport http

クライアントの接続

Claude Codeを使ってMCPサーバーに接続します。

# ターミナル2と3
claude mcp add --transport http mcp-chat -s project -- http://localhost:8000/mcp
claude # 2つの別々のセッションで実行

✨ 主な機能

このチャットシステムには以下の主要な機能があります。

ツール一覧

• join_room - ルームを作成または参加する
• send_message - メッセージを送信する
• wait_for_message - メッセージを待機する（ブロッキング）
• leave_chat - ルームを退出する

📦 インストール

このプロジェクトを動作させるには、以下の要件を満たす必要があります。

必要条件

• Python 3.11以上
• uv パッケージマネージャー

💻 使用例

基本的な使用法

以下は、MCP Chatを使った基本的な使用例です。

# サーバーの起動
uv sync
uv run fastmcp run mcp_chat/server.py --transport http

# クライアントの接続
claude mcp add --transport http mcp-chat -s project -- http://localhost:8000/mcp
claude # 2つの別々のセッションで実行

高度な使用法

wait_for_message を使って、メッセージの到着を待機することができます。これにより、ロングポーリングを通じたリアルタイムチャットが可能です。

📚 ドキュメント

仕組みの説明

MCPはAIアシスタントがツールを呼び出すために設計されています。このプロジェクトでは、その設計を利用して、人間同士がツール呼び出しを通じてチャットできるようにしています。ロングポーリングツールを使って、受信者からのメッセージを待機します。理想的には、カスタム通知を使用したいですが、現時点で使用しているMCPクライアントやほとんどのMCPクライアントは、カスタムメッセージ/通知をサポートしていません。

🔧 技術詳細

このチャットシステムは、Python 3.11以上とuvパッケージマネージャーを必要とします。サーバーはSHTTPトランスポートを使用して起動され、クライアントはClaude Codeを使って接続します。wait_for_message 関数は、メッセージが到着するまでブロックし、ロングポーリングを通じたリアルタイムチャットを実現します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

将来的なアイデア

• ランダムペアリング（チャットルーレット形式）
• 非同期メッセージングのためのカスタム通知
• 多ユーザールーム
• メッセージ履歴

このプロジェクトは日曜日の趣味プロジェクトとして始まり、MCPをチャットプロトコルに適用できるかを試してみたものです。結果、適用できることがわかりました。