Interact MCP

交互MCP

一个交互式MCP（模型上下文协议）服务器，通过基于网络的聊天界面实现人工智能助手和用户之间的实时通信。

概述

该项目为MCP服务器提供了一个 interact 该工具允许AI助手：

• 提出问题并接收用户的回复
• 请求确认行动
• 寻求指导或澄清
• 实时共享信息

该服务器具有基于Gradio的web界面，为无缝用户交互提供聊天UI。

特性

• 实时交互：人工智能与用户之间的双向沟通
• 基于Web的聊天界面：由Gradio提供支持的干净、现代的用户界面
• 多种运输方式：支持stdio和SSE（服务器发送事件）传输
• 超时处理：用户响应的自动超时保护
• 聊天历史记录：在会话期间维护对话历史记录

安装

1. 克隆此存储库：

git clone 
cd interact-mcp

1. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 安装依赖项：

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通信。

使用聊天界面

1. web界面将在浏览器中自动打开
2. 等待AI助手消息出现
3. 回答文本输入框中的问题或提示
4. 您的回复将通过MCP协议发送回AI助手

添加到游标IDE

要将此MCP服务器与Cursor IDE一起使用，您需要在MCP配置文件中对其进行配置。

1. 打开Cursor IDE并转到 光标设置>工具和集成 然后单击“新建MCP服务器”
2. 这将打开 ~/.cursor/mcp.json 用于编辑的文件
3. 添加以下配置：

{
    "mcpServers": {
        "interact": {
            "command": "path/to/interact-mcp/venv/bin/python3",
            "args": ["path/to/interact-mcp/server.py", "--stdio"]
        }
    }
}

1. 替换 path/to/interact-mcp 带有项目目录的实际路径
2. 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服务器操作的线程
• 通过定期刷新机制支持实时更新

贡献

欢迎投稿！请随时提交问题或拉取请求。