交互MCP
一个交互式MCP（模型上下文协议）服务器，通过基于网络的聊天界面实现人工智能助手和用户之间的实时通信。
概述
该项目为MCP服务器提供了一个 interact 该工具允许AI助手：
- 提出问题并接收用户的回复
- 请求确认行动
- 寻求指导或澄清
- 实时共享信息
该服务器具有基于Gradio的web界面，为无缝用户交互提供聊天UI。
特性
- 实时交互：人工智能与用户之间的双向沟通
- 基于Web的聊天界面：由Gradio提供支持的干净、现代的用户界面
- 多种运输方式：支持stdio和SSE（服务器发送事件）传输
- 超时处理：用户响应的自动超时保护
- 聊天历史记录：在会话期间维护对话历史记录
安装
- 克隆此存储库：
git clone
cd interact-mcp- 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate- 安装依赖项：
pip install fastmcp gradio用法
运行服务器
选项1:SSE传输（默认）
python server.py这将启动服务器 127.0.0.1:3033 并在浏览器中自动打开聊天界面。
选项2：自定义端口
python server.py sse 8080为SSE传输指定自定义端口。
选项3：标准运输
python server.py --stdio使用stdio传输进行直接MCP通信。
使用聊天界面
- web界面将在浏览器中自动打开
- 等待AI助手消息出现
- 回答文本输入框中的问题或提示
- 您的回复将通过MCP协议发送回AI助手
添加到游标IDE
要将此MCP服务器与Cursor IDE一起使用，您需要在MCP配置文件中对其进行配置。
- 打开Cursor IDE并转到 光标设置>工具和集成 然后单击“新建MCP服务器”
- 这将打开
~/.cursor/mcp.json用于编辑的文件 - 添加以下配置：
{
"mcpServers": {
"interact": {
"command": "path/to/interact-mcp/venv/bin/python3",
"args": ["path/to/interact-mcp/server.py", "--stdio"]
}
}
}- 替换
path/to/interact-mcp带有项目目录的实际路径 - Gradio UI应在浏览器中自动打开
MCP工具
interact(message: str) -> str
该服务器提供的主要工具允许AI助手与用户进行交互。
参数：
message（str）：要发送给用户的消息
退货：
str：用户对消息的响应
超时：
- 默认超时为5分钟（300秒）
- 如果没有收到响应，则返回超时消息
建筑可执行文件
包含一个PyInstaller规范文件，用于创建独立的可执行文件：
pyinstaller server.spec这将创建一个 dist/server 包含所有必要依赖项的可执行文件。
技术细节
- 内置于 FastMCP 框架
- 使用Gradio作为web界面
- 实现并发web UI和MCP服务器操作的线程
- 通过定期刷新机制支持实时更新
贡献
欢迎投稿！请随时提交问题或拉取请求。