MCP Helper 使用文档

📖 目录

一、插件简介

MCP Helper 是一个 Cursor 扩展插件，提供便捷的文件解析和提示词管理功能。通过该扩展，您可以：

🚀 核心功能

  1. 文档管理：上传并管理文档（支持 PDF、Word、Excel、CSV、Markdown、HTML）
  2. 提示词管理：管理和使用提示词模板，提升AI交互效率
  3. 工作流优化：使用预设工作流提高工作效率

💡 核心价值：MCP Helper 弥补了 Cursor 在文件处理和提示词管理方面的短板，让您的开发工作更加高效便捷。

二、安装插件

  1. 1 下载插件：

    📦 下载最新版本：

    立即下载 mcp-helper-1.0.3.vsix

    文件大小：795KB | 版本：1.0.3 | 更新时间：2024年

  2. 2 打开Cursor：使用快捷键 Ctrl+Shift+P
    Cursor命令面板截图

    图一：在Cursor中按 Ctrl+Shift+P 打开命令面板，搜索并选择 "Extensions: Install from VSIX..."

  3. 3 选择文件：找到并选择下载的 mcp-file-helper-1.0.3.vsix 文件
  4. 4 安装完成：点击 "安装" 按钮即可

⚠️ 重要提醒：Cursor安装扩展后，需要重启插件才能生效。

三、使用方式

🎯 两种启动方式

方法一：Cursor页面右下角活动区，点击"MCP助手"。

方法二：任意文件【右键】菜单选中"MCP助手"。

初始配置

初次使用需要获取Token令牌：

MCP配置界面截图

图二：MCP配置界面，展示API令牌认证和MCP服务器连接配置流程。
Token账号：test　密码：test
输入账号密码后点击"获取"按钮获取Token，然后点击"连接"按钮完成配置。

✅ 配置成功标志：MCP配置从"未连接"变为"已连接"则配置成功，接下来就可以使用知识库功能，上传本地文档，利用MCP工具进行文档解析了。

四、功能简介

📚 知识库管理

支持以下文件类型的上传、删除：

  • PDF文件：.pdf
  • Word文档：.doc, .docx
  • Excel文件：.xls, .xlsx, .xlsm
  • CSV文件：.csv
  • Markdown文件：.md
  • HTML文件：.html
文件管理界面截图

图三：知识库文件管理界面。点击"知识库"选项卡，可以上传本地文档、查看文件列表。支持复制文件解析结果到MCP工具命令，也可以删除不需要的文件。

🤖 AI交互使用

将复制的内容复制到Cursor的Chat对话框，选择Agent模式，模型选择claude-3.5或者claude-3.7。

🖼️ [Agent模式选择截图]
显示：Chat界面、Agent模式、模型选择
AI对话示例截图

图四：AI对话示例，展示MCP工具调用过程。用户提出"我需要解析这个Word文档"后，AI自动调用MCP工具parse_word，返回完整的文档解析内容，包括交互规范、接口类型、主要接口等结构化信息。

🎯 使用效果：之后就可以基于文档内容进行开发或者其他工作了。AI能够理解您上传的文档内容，提供更精准的建议和帮助。

五、更新日志

本文档记录了"MCP助手"扩展的所有重要更新。

版本 1.0.3

🚀 功能改进 (Improvements)
  • 优化域名连接支持，提高域名服务器连接的兼容性
  • 改进MCP配置文件的处理逻辑，增强跨域请求支持
  • 优化字体加载机制，使用通用字体替代不可用字体
  • 增强错误处理和日志记录，提供更清晰的故障排查信息
  • 提升文件解析组件的性能，加快大型Excel文件的处理速度
🐛 问题修复 (Fixes)
  • 修复使用域名连接MCP服务器时出现的"Client closed"错误
  • 修复某些情况下HTTPS证书验证失败导致连接中断的问题
  • 解决插件字体加载失败的问题，改用Figma支持的标准字体
  • 修复文件上传过程中偶发的连接中断问题
  • 解决工作区预览在某些环境下显示异常的问题

版本 1.0.2

🚀 功能改进 (Improvements)
  • 新增"工作区"选项卡，提供MCP工具执行过程可视化界面
  • 工作区中增加"浏览器预览"功能，可在VSCode中直接嵌入远程VNC页面，实现实时浏览和操作
  • 新增"在浏览器中打开"按钮，解决跨域限制问题，支持在外部浏览器中操作VNC
  • 优化浏览器预览密码显示及复制功能，点击密码即可复制，提高使用体验
  • 新增浏览器控制MCP工具：browser-mcp，可通过自然语言控制浏览器
  • 优化了文件上传和处理流程，提高了文件处理的稳定性
  • 改进了用户界面交互体验，使操作更加直观
🐛 问题修复 (Fixes)
  • 修复MCP配置卡片中"配置"按钮点击无响应的问题
  • 修复browser-mcp连接使用错误URL的问题，确保各卡片使用正确的服务器地址

版本 1.0.1

🚀 功能改进 (Improvements)
  • 优化了所有界面组件，更好地适配VSCode主题样式
  • 优化了工作流步骤区块的布局和视觉呈现
  • 调整了提示词模板内框样式，确保内容不超出外框
  • 移除了预览区域的边框，提供更连贯的视觉体验
  • 统一了各组件的背景色和间距，提升整体美观度
  • 添加了安装或更新后的重启提示功能，确保扩展功能正常加载
  • 添加了打开MCP配置文件按钮，方便用户直接编辑MCP配置
  • 实现面板单例模式，在已有打开面板的情况下复用现有实例，避免创建多个重复页面
🐛 问题修复 (Fixes)
  • 修复了工作流步骤顺序混乱的问题，现在步骤按照添加顺序正确显示
  • 修复了工作流步骤删除后仍然存在的问题，确保删除操作完全生效
  • 优化了工作流步骤的本地存储逻辑，防止出现重复或无效步骤
  • 修复了文件列表"全部删除"功能不工作的问题，实现了并行批量删除
  • 修复了文件数量恰好等于每页限制时文件列表不显示的问题

版本 1.0.0

🎉 新增功能 (Additions)
  • 初始版本发布
  • 文件上传功能，支持PDF、Word、Excel和CSV格式
  • 文件列表管理，支持复制和删除操作
  • 提示词列表功能，包含默认和自定义提示词
  • 工作流功能，支持变量替换和提示词生成
  • 文件和提示词的分页管理功能
  • 中英双语安装和使用指南
  • 文件类型提示优化，提供更清晰的用户指引
  • 更新默认提示词，包含代码解释器、IT架构师和数据库专家模板
  • 修复提示词列表的分页和删除功能
  • 修复工作流步骤预览更新逻辑