MCP Chat

🚀 MCP Chat

MCP Chat 藉助 MCP（模型上下文協議）服務器實現用戶間的聊天功能。它最初的靈感來源於類似聊天輪盤的交互設想，可讓用戶通過如 Claude Mac 應用或 Claude Code 這類 MCP 客戶端進行交流。本項目作為概念驗證，採用了簡單的基於內存的房間系統，支持單個房間內的兩名用戶相互發送消息。

🚀 快速開始

運行 MCP 服務器

使用 SHTTP 傳輸協議運行 MCP 服務器：

# 終端 1
uv sync
uv run fastmcp run mcp_chat/server.py --transport http

連接到 MCP 服務器

以 Claude Code 為例，連接到 MCP 服務器：

注意：可參考演示動圖瞭解如何在 Claude Code 中使用。

# 終端 2 和 3
claude mcp add --transport http mcp-chat -s project -- http://localhost:8000/mcp
claude # 在兩個獨立會話中執行此操作

實現實時聊天

wait_for_message 函數會阻塞，直到收到消息，從而通過長輪詢實現實時聊天。

✨ 主要特性

房間系統

支持用戶創建或加入房間，在單個房間內實現兩人之間的消息交互。

工具豐富

提供了一系列實用工具，方便用戶進行聊天操作：

• join_room：創建/加入房間
• send_message：發送消息
• wait_for_message：等待消息（阻塞！）
• leave_chat：離開房間

📦 安裝指南

環境要求

• Python 3.11 及以上版本
• uv 包管理器

💻 使用示例

基礎用法

# 運行 MCP 服務器
uv sync
uv run fastmcp run mcp_chat/server.py --transport http

# 連接到 MCP 服務器
claude mcp add --transport http mcp-chat -s project -- http://localhost:8000/mcp

高級用法

在不同的終端會話中，使用 claude 命令進行多用戶交互，通過 wait_for_message 實現實時消息接收。

📚 詳細文檔

MCP 協議利用

MCP 原本是為 AI 助手調用工具而設計的，本項目巧妙地利用這一設計，讓人類通過工具調用實現相互聊天。由於當前使用的 MCP 客戶端大多不支持自定義消息/通知，因此採用了長輪詢工具來等待接收方的消息。

未來規劃

• 隨機配對：實現類似聊天輪盤的隨機配對功能。
• 自定義通知：支持異步消息的自定義通知。
• 多用戶房間：擴展房間系統，支持多個用戶在同一房間內聊天。
• 消息歷史：保存聊天消息歷史記錄。

📄 許可證

本項目採用 MIT 許可證。