[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-srbhptl39--MCP-SuperAssistant":3,"tool-srbhptl39--MCP-SuperAssistant":64},[4,17,25,39,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,14,15],"开发框架","Agent","语言模型","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":10,"last_commit_at":23,"category_tags":24,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,15],{"id":26,"name":27,"github_repo":28,"description_zh":29,"stars":30,"difficulty_score":10,"last_commit_at":31,"category_tags":32,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[33,34,35,36,14,37,15,13,38],"图像","数据工具","视频","插件","其他","音频",{"id":40,"name":41,"github_repo":42,"description_zh":43,"stars":44,"difficulty_score":45,"last_commit_at":46,"category_tags":47,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,3,"2026-04-04T04:44:48",[14,33,13,15,37],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":45,"last_commit_at":54,"category_tags":55,"status":16},519,"PaddleOCR","PaddlePaddle\u002FPaddleOCR","PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来，转换成计算机可读取的结构化数据，让机器真正“看懂”图文内容。\n\n面对海量纸质或电子文档，PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域，它扮演着连接图像与大型语言模型（LLM）的桥梁角色，能将视觉信息直接转化为文本输入，助力智能问答、文档分析等应用场景落地。\n\nPaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显：不仅支持全球 100 多种语言的识别，还能在 Windows、Linux、macOS 等多个系统上运行，并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目，PaddleOCR 既能满足快速集成的需求，也能支撑前沿的视觉语言研究，是处理文字识别任务的理想选择。",74913,"2026-04-05T10:44:17",[15,33,13,37],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":45,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[15,14,13,36],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":81,"owner_twitter":75,"owner_website":79,"owner_url":82,"languages":83,"stars":100,"forks":101,"last_commit_at":102,"license":103,"difficulty_score":104,"env_os":105,"env_gpu":106,"env_ram":106,"env_deps":107,"category_tags":113,"github_topics":114,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":128,"updated_at":129,"faqs":130,"releases":131},3978,"srbhptl39\u002FMCP-SuperAssistant","MCP-SuperAssistant","Brings MCP to ChatGPT, DeepSeek, Perplexity, Grok, Gemini, Google AI Studio, OpenRouter, DeepSeek, T3 Chat and more...","MCP SuperAssistant 是一款浏览器扩展插件，旨在打破各大主流 AI 聊天平台与本地数据之间的壁垒。它核心解决了当前网页版 AI 助手（如 ChatGPT、Gemini、Perplexity、Grok 等）无法直接访问用户本地文件、数据库或业务工具的痛点。通过集成由 Anthropic 推出的模型上下文协议（MCP），该插件让用户无需切换窗口或编写复杂代码，即可在熟悉的对话界面中直接调用本地资源，显著提升了 AI 处理实际任务的深度与准确性。\n\n这款工具特别适合开发者、数据分析师以及需要频繁结合本地环境进行工作的研究人员使用，同时也适合希望让 AI 更懂个人数据的进阶普通用户。其独特的技术亮点在于广泛的兼容性，不仅支持 Chrome 和 Firefox 浏览器，还无缝适配包括 GitHub Copilot、Kimi、通义千问在内的十余种热门 AI 服务平台。作为连接 AI 模型与现实数据的通用桥梁，MCP SuperAssistant 以轻量化的方式实现了“万能接口”的功能，让智能助手真正融入你的工作流。","\n\u003Cdiv align=\"center\">\n   \u003C!-- \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_284c32b761d7.png\" alt=\"MCP SuperAssistant Logo\" width=\"100\" height=\"100\"> -->\n   \u003Ch1>MCP SuperAssistant Chrome Extension\u003C\u002Fh1>\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\nBrings MCP to ChatGPT, Perplexity, Grok, Gemini, Google AI Studio, OpenRouter, Kimi, Github Copilot, Mistral and more...\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n   \u003Ca href=\"https:\u002F\u002Fmcpsuperassistant.ai\u002F\" target=\"_blank\">\u003Cstrong>🌐 Visit Official Website\u003C\u002Fstrong>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C!-- ![MCP SuperAssistant](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_469596fbd1b7.jpg) -->\n\u003Cdiv align=\"center\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_62e0691e652c.jpg\" alt=\"MCP SuperAssistant Cover\" width=\"800\">\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n   \n   ![Latest Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fsrbhptl39\u002FMCP-SuperAssistant?style=flat-square&label=Latest%20Release&color=brightgreen)\n   ![GitHub Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsrbhptl39\u002FMCP-SuperAssistant?style=flat-square&label=Stars)\n   ![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue?style=flat-square)\n   ![Chrome Users](https:\u002F\u002Fimg.shields.io\u002Fchrome-web-store\u002Fusers\u002Fkngiafgkdnlkgmefdafaibkibegkcaef?style=flat-square&label=Chrome%20Users)\n   ![Firefox Users](https:\u002F\u002Fimg.shields.io\u002Famo\u002Fusers\u002Fmcp-superassistant?style=flat-square&label=Firefox%20Users)\n   ![Build Status](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStatus-Active-success?style=flat-square)\n\n\u003C\u002Fdiv>\n\n## Installation\n\n\u003Cdiv align=\"center\" style=\"display: flex; justify-content: center; gap: 20px; align-items: center;\">\n   \u003Ca href=\"https:\u002F\u002Fchromewebstore.google.com\u002Fdetail\u002Fmcp-superassistant\u002Fkngiafgkdnlkgmefdafaibkibegkcaef?hl=en\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_d554d50717e1.png\" alt=\"Chrome Web Store\" width=\"200\" height=\"auto\" style=\"vertical-align: middle;\" \u002F>\u003C\u002Fa>\n   \u003Ca href=\"https:\u002F\u002Faddons.mozilla.org\u002Fen-US\u002Ffirefox\u002Faddon\u002Fmcp-superassistant\u002F\">\u003Cimg src=\"https:\u002F\u002Fblog.mozilla.org\u002Faddons\u002Ffiles\u002F2015\u002F11\u002Fget-the-addon.png\" alt=\"Firefox Add-ons\" width=\"200\" height=\"auto\" style=\"vertical-align: middle;\" \u002F>\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## Overview\n\nMCP SuperAssistant is a Chrome extension that integrates the Model Context Protocol (MCP) tools with AI platforms like Perplexity, ChatGPT, Google Gemini, Google AI Studio, Grokand more. It allows users to execute MCP tools directly from these platforms enhancing the capabilities of web-based AI assistants.\n\n## Currently Supported Platforms\n\n- [ChatGPT](https:\u002F\u002Fchatgpt.com\u002F)\n- [Google Gemini](https:\u002F\u002Fgemini.google.com\u002F)\n- [Perplexity](https:\u002F\u002Fperplexity.ai\u002F)\n- [Grok](https:\u002F\u002Fgrok.com\u002F)\n- [Google AI Studio](https:\u002F\u002Faistudio.google.com\u002F)\n- [OpenRouter Chat](https:\u002F\u002Fopenrouter.ai\u002Fchat)\n- [DeepSeek](https:\u002F\u002Fchat.deepseek.com\u002F)\n- [T3 Chat](https:\u002F\u002Ft3.chat\u002F)\n- [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Fcopilot)\n- [Mistral AI](https:\u002F\u002Fchat.mistral.ai\u002F)\n- [Kimi](https:\u002F\u002Fkimi.com\u002F)\n- [Qwen Chat](https:\u002F\u002Fchat.qwen.ai\u002F)\n- [Z Chat](https:\u002F\u002Fchat.z.ai\u002F)\n\n\n## Demo Video\n\nKimi.com\n\n[![MCP SuperAssistant Demo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_4b30c9c17244.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=jnBPh2jzunM)\n\nChatGPT\n\n[![MCP SuperAssistant Demo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_0734cf4082eb.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=PY0SKjtmy4E)\n\nWatch the demo to see MCP SuperAssistant in action!\n\n[MCP SuperAssistant Demo Playlist](https:\u002F\u002Fwww.youtube.com\u002Fplaylist?list=PLOK1DBnkeaJFzxC4M-z7TU7_j04SShX_w)\n\n## Setup Tutorial\n\n[![Setup Tutorial](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_db6019c6e0e7.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=h9f_GX1Ef20&pp=ygUTbWNwIHN1cGVyIGFzc2lzdGFudA%3D%3D)\n\n**New to MCP SuperAssistant?** Watch this complete setup guide to get started in minutes!\n\n[View Setup Tutorial](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=h9f_GX1Ef20&pp=ygUTbWNwIHN1cGVyIGFzc2lzdGFudA%3D%3D)\n\n## What is MCP?\n\nThe Model Context Protocol (MCP) is an open standard developed by Anthropic that connects AI assistants to systems where data actually lives, including content repositories, business tools, and development environments. It serves as a universal protocol that enables AI systems to securely and dynamically interact with data sources in real time.\n\n## Key Features\n\n- **Multiple AI Platform Support**: Works with ChatGPT, Perplexity, Google Gemini, Grok, Google AI Studio, OpenRouter Chat, DeepSeek, Kagi, T3 Chat, GitHub Copilot, Mistral AI, Kimi, Qwen Chat, Z Chat and more\n- **Tool Detection**: Automatically detects MCP tool calls in AI responses\n- **Tool Execution**: Execute MCP tools with a single click\n- **Tool Result Integration**: Seamlessly insert tool execution results back into the AI conversation\n- **Render Mode**: Renders Function call and Function results. \n- **Auto-Execute Mode**: Automatically execute detected tools\n- **Auto-Submit Mode**: Automatically submit chat input after result insertion\n- **Push Content Mode**: Option to push page content instead of overlaying\n- **Preferences Persistence**: Remembers sidebar position, size, and settings\n- **Dark\u002FLight Mode Support**: Adapts to the AI platform's theme\n\n```mermaid\nflowchart TD\n    A[AI Chat Interface] -->|Generate| B[Tool Calls]\n    B -->|Detect| C[Extension Detects Tool Calls]\n    C -->|Send via SSE| D[MCP Local Proxy Server]\n    D -->|Forward| E[Actual MCP Server]\n    E -->|Return Results| D\n    D -->|Return Results| C\n    C -->|Insert| F[Add Results Back to Chat]\n```\n\n### Connecting to Local Proxy Server\n\nTo connect the Chrome extension to a local server for proxying connections:\n\n#### Run MCP SuperAssistant Proxy via npx:\n\n1. Create a `config.json` file with your MCP server details. For example, to use the [Desktop Commander](https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP):\n\n\n   **Example config.json:**\n   ```json\n   {\n     \"mcpServers\": {\n       \"desktop-commander\": {\n         \"command\": \"npx\",\n         \"args\": [\n           \"-y\",\n           \"@wonderwhy-er\u002Fdesktop-commander\"\n         ]\n       }\n     }\n   }\n   ```\n   config.json also support other MCP server configurations like remote MCP server URLs.\n   Try composio mcp, zappier mcp, or smithery or any other remote MCP server.\n\n   **Or use existing config file location from Cursor or other tools:**\n   ```\n   macOS: ~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json\n   Windows: %APPDATA%\\Claude\\claude_desktop_config.json\n   ```\n\n2. Start the MCP SuperAssistant Proxy server using one of the following commands:\n\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy@latest --config .\u002Fconfig.json --outputTransport sse\n   ```\n   or \n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy --config .\u002Fconfig.json --outputTransport streamableHttp\n   ```\n   or\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy --config .\u002Fconfig.json --outputTransport ws\n   ```\n\n   **View all available options:**\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy@latest --help\n   ```\n   \n   This is useful for:\n   - Proxying remote MCP servers\n   - Adding CORS support to remote servers\n   - Providing health endpoints for monitoring\n\n#### Connection Steps:\n\n1. Start the proxy server using one of the commands above\n2. Open the MCP SuperAssistant sidebar in one of the supported AI platforms, this should show the sidebar UI\n3. Click on the server status indicator (usually showing as \"Disconnected\")\n4. Enter the local server URL (default: `http:\u002F\u002Flocalhost:3006\u002Fsse`)\n   URL format depends on the --outputTransport method used:\n   - For SSE: `http:\u002F\u002Flocalhost:3006\u002Fsse`\n   - For Streamable HTTP: `http:\u002F\u002Flocalhost:3006\u002Fmcp`\n   - For WebSocket: `ws:\u002F\u002Flocalhost:3006\u002Fmessage`\n   - Choose the appropriate transport method (SSE or Streamable HTTP or WebSocket) \n   - You can add any remote MCP server URL here as well, if it supports CORS or is proxied via this local proxy server. Try [Composio mcp](https:\u002F\u002Fmcp.composio.dev\u002F), [Zappier mcp](https:\u002F\u002Fzapier.com\u002Fmcp), or [smithery](https:\u002F\u002Fsmithery.ai\u002F) or any other remote MCP server.\n5. Click \"Connect\" to establish the connection\n6. The status indicator should change to \"Connected\" if successful\n\n## Usage\nExample Workflow:\n1. Navigate to a supported AI platform example chatgpt.\n2. The MCP SuperAssistant sidebar will appear on the right side of the page\n3. Configure your MCP Tools to enable and disable the tools you want to use.\n4. In the message prompt area, hover the 'MCP' button to see the available tools and their descriptions.\n5. MCP SuperAssistant requires to add an MCP working instructions prompt to the chat, to give details of its new capabilities and how to use the tools. Use the 'Insert' or attach button to add the instructions prompt.\n6. Once the instructions prompt is added, Now you can ask it to read files or any related MCP tool operations.\n7. When AI wants to use any tool it will show a custom tool call card with the tool name and parameters.\n8. User can manually execute the tool call by clicking on the \"RUN\" button on the tool call card, or if Auto-Execute mode is enabled, it will execute automatically.\n9. Automation can be achieved by enabling Auto-Execute and Auto-Submit modes, by clicking on the 'MCP' button and configuring the Auto modes.\n\n\n## Tips & Tricks\n\n1. **Turn off search mode** (chatgpt, perplexity) in AI chat interfaces for better tool call prompt experience and to prevent MCP SuperAssistant from getting derail.\n2. **Turn on Reasoning mode** (chatgpt, perplexity, grok) in AI chat interfaces, which will help the AI to understand the context better and generate the correct tool calls.\n3. Use newer high-end models as they are better at understanding the context and generating the correct tool calls.\n4. Copy the MCP instructions prompt and paste it in the AI chat system prompt (Google AI Studio).\n5. Mention the specific tools you want to use in your conversation.\n6. Use the MCP Auto toggles to control the tool execution.\n\n## Common Issues with MCP SuperAssistant\n\nThis page covers the most common issues users encounter with MCP SuperAssistant and provides solutions to resolve them.\n\n### 1. Extension Not Detecting Tool Calls\n\n- Make sure the extension is enabled in your browser.\n- Make sure the **mcp prompt instructions are properly attached or inserted** in the chat, before starting any chat.\n- Check that your AI platform supports tool calls and that the feature is enabled.\n- Refresh the page or restart your browser if the issue persists.\n\n### 2. Tool Execution Fails\n\n- Ensure your proxy server is running and the URL is correct in the sidebar server settings.\n- check your config.json file for any errors or formatting issues.\n- Check your network connectivity and firewall settings.\n\n### 3. Connection Issues\n\n- Ensure that your MCP server is running and accessible.\n- Check the server URL in the extension settings.\n- First start the npx mcp-SuperAssistant-proxy server and then reload\u002Frestart the extension from chrome:\u002F\u002Fextensions\u002F page.\n- Check the proxy server logs for any errors or issues.\n- Ensure that your firewall or antivirus software is not blocking the connection.\n- Make sure the server shows the proper connected status and exposes the `\u002Fsse` endpoint.\n\n### 4. Incorrect tool call format \n\n- There are times model does not generate correct tool call format as requested, this makes the tool detection to fail.\nIn such cases, use better models which are meant for tool calling or have better tool calling capabilities.\n- Use the custom instructions prompt, which can be found in the MCP SuperAssistant sidebar.\n- Ask explicitily to use the tools by mentioning them in the prompt.\n- This Below is an example of correct MCP function call format, which is rendered by MCP SuperAssistant extension:\n\n```\n```jsonl\n{\"type\": \"function_call_start\", \"name\": \"function_name\", \"call_id\": 1}\n{\"type\": \"description\", \"text\": \"Short 1 line of what this function does\"}\n{\"type\": \"parameter\", \"key\": \"parameter_1\", \"value\": \"value_1\"}\n{\"type\": \"parameter\", \"key\": \"parameter_2\", \"value\": \"value_2\"}\n{\"type\": \"function_call_end\", \"call_id\": 1}\n```\n```\n\n### Manual Installation (Development)\n\n#### Release Version\n1. Download the latest release from [Releases](https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Freleases)\n2. Unzip the downloaded file\n3. Navigate to `chrome:\u002F\u002Fextensions\u002F` in Chrome\n4. Enable \"Developer mode\"\n5. Click \"Load unpacked\" and select the unzipped directory\n6. Follow [Connecting to Local Proxy Server](#connecting-to-local-proxy-server) to connect to your MCP server\n\n## Development\n\n### Prerequisites\n\n- Node.js (v16+)\n- pnpm\n\n### Setup\n\n```bash\n# Install dependencies\npnpm install\n\n# Start development server\npnpm dev\n\n# Build for production\npnpm build\n\n# Create zip package for distribution\npnpm zip\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature\u002Famazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature\u002Famazing-feature`)\n5. Open a Pull Request\n\n## Author\n\n### [Saurabh Patel](https:\u002F\u002Fgithub.com\u002Fsrbhptl39)\n\n## Sponsor & Support\n\nThis project is developed entirely in my spare time, driven by a passion for AI and the Model Context Protocol (MCP). As a full-time professional, balancing work commitments with open-source development makes it challenging to contribute regularly and maintain the pace of updates.\n\nYour support helps me dedicate more time to:\n- 🐛 Fixing bugs and addressing issues\n- ✨ Adding new features and platform support\n- 📚 Improving documentation and tutorials\n- 🔄 Keeping dependencies up-to-date\n- 💬 Responding to community requests\n\n**Support this project:**\n- ⭐ Star the repository to show your appreciation\n- 💖 [Sponsor on GitHub](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fsrbhptl39) to help sustain development\n- 🐦 Follow me on [Twitter](https:\u002F\u002Ftwitter.com\u002Fsrbhptl39) (@srbhptl39) for updates\n- 📧 For private support or custom implementations, reach out via [Twitter](https:\u002F\u002Ftwitter.com\u002Fsrbhptl39)\n\nEvery contribution, big or small, helps keep this project alive and thriving! 🙏\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\n- Inspired by the [Model Context Protocol (MCP)](https:\u002F\u002Fmodelcontextprotocol.io\u002F) by Anthropic\n- Thanks to [Cline](https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline) for idea inspiration\n- Built with [Chrome Extension Boilerplate with React + Vite](https:\u002F\u002Fgithub.com\u002FJonghakseo\u002Fchrome-extension-boilerplate-react-vite)\n\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_9ab125d80a1f.png)](https:\u002F\u002Fwww.star-history.com\u002F#srbhptl39\u002FMCP-SuperAssistant&Date)\n","\u003Cdiv align=\"center\">\n   \u003C!-- \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_284c32b761d7.png\" alt=\"MCP SuperAssistant Logo\" width=\"100\" height=\"100\"> -->\n   \u003Ch1>MCP SuperAssistant Chrome 扩展\u003C\u002Fh1>\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\n将 MCP 带入 ChatGPT、Perplexity、Grok、Gemini、Google AI Studio、OpenRouter、Kimi、Github Copilot、Mistral 等平台……\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n   \u003Ca href=\"https:\u002F\u002Fmcpsuperassistant.ai\u002F\" target=\"_blank\">\u003Cstrong>🌐 访问官方网站\u003C\u002Fstrong>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C!-- ![MCP SuperAssistant](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_469596fbd1b7.jpg) -->\n\u003Cdiv align=\"center\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_62e0691e652c.jpg\" alt=\"MCP SuperAssistant 封面\" width=\"800\">\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n   \n   ![最新版本](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fsrbhptl39\u002FMCP-SuperAssistant?style=flat-square&label=Latest%20Release&color=brightgreen)\n   ![GitHub 星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsrbhptl39\u002FMCP-SuperAssistant?style=flat-square&label=Stars)\n   ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue?style=flat-square)\n   ![Chrome 用户数](https:\u002F\u002Fimg.shields.io\u002Fchrome-web-store\u002Fusers\u002Fkngiafgkdnlkgmefdafaibkibegkcaef?style=flat-square&label=Chrome%20Users)\n   ![Firefox 用户数](https:\u002F\u002Fimg.shields.io\u002Famo\u002Fusers\u002Fmcp-superassistant?style=flat-square&label=Firefox%20Users)\n   ![构建状态](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStatus-Active-success?style=flat-square)\n\n\u003C\u002Fdiv>\n\n## 安装\n\n\u003Cdiv align=\"center\" style=\"display: flex; justify-content: center; gap: 20px; align-items: center;\">\n   \u003Ca href=\"https:\u002F\u002Fchromewebstore.google.com\u002Fdetail\u002Fmcp-superassistant\u002Fkngiafgkdnlkgmefdafaibkibegkcaef?hl=en\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_d554d50717e1.png\" alt=\"Chrome Web Store\" width=\"200\" height=\"auto\" style=\"vertical-align: middle;\" \u002F>\u003C\u002Fa>\n   \u003Ca href=\"https:\u002F\u002Faddons.mozilla.org\u002Fen-US\u002Ffirefox\u002Faddon\u002Fmcp-superassistant\u002F\">\u003Cimg src=\"https:\u002F\u002Fblog.mozilla.org\u002Faddons\u002Ffiles\u002F2015\u002F11\u002Fget-the-addon.png\" alt=\"Firefox Add-ons\" width=\"200\" height=\"auto\" style=\"vertical-align: middle;\" \u002F>\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## 概述\n\nMCP SuperAssistant 是一款 Chrome 扩展，可将模型上下文协议（MCP）工具与 Perplexity、ChatGPT、Google Gemini、Google AI Studio、Grok 等 AI 平台集成。它允许用户直接从这些平台执行 MCP 工具，从而增强基于 Web 的 AI 助手的功能。\n\n## 当前支持的平台\n\n- [ChatGPT](https:\u002F\u002Fchatgpt.com\u002F)\n- [Google Gemini](https:\u002F\u002Fgemini.google.com\u002F)\n- [Perplexity](https:\u002F\u002Fperplexity.ai\u002F)\n- [Grok](https:\u002F\u002Fgrok.com\u002F)\n- [Google AI Studio](https:\u002F\u002Faistudio.google.com\u002F)\n- [OpenRouter Chat](https:\u002F\u002Fopenrouter.ai\u002Fchat)\n- [DeepSeek](https:\u002F\u002Fchat.deepseek.com\u002F)\n- [T3 Chat](https:\u002F\u002Ft3.chat\u002F)\n- [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Fcopilot)\n- [Mistral AI](https:\u002F\u002Fchat.mistral.ai\u002F)\n- [Kimi](https:\u002F\u002Fkimi.com\u002F)\n- [Qwen Chat](https:\u002F\u002Fchat.qwen.ai\u002F)\n- [Z Chat](https:\u002F\u002Fchat.z.ai\u002F)\n\n\n## 演示视频\n\nKimi.com\n\n[![MCP SuperAssistant 演示](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_4b30c9c17244.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=jnBPh2jzunM)\n\nChatGPT\n\n[![MCP SuperAssistant 演示](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_0734cf4082eb.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=PY0SKjtmy4E)\n\n观看演示，了解 MCP SuperAssistant 的实际应用！\n\n[MCP SuperAssistant 演示播放列表](https:\u002F\u002Fwww.youtube.com\u002Fplaylist?list=PLOK1DBnkeaJFzxC4M-z7TU7_j04SShX_w)\n\n## 设置教程\n\n[![设置教程](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_db6019c6e0e7.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=h9f_GX1Ef20&pp=ygUTbWNwIHN1cGVyIGFzc2lzdGFudA%3D%3D)\n\n**初次使用 MCP SuperAssistant？** 观看本完整设置指南，几分钟内即可上手！\n\n[查看设置教程](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=h9f_GX1Ef20&pp=ygUTbWNwIHN1cGVyIGFzc2lzdGFudA%3D%3D)\n\n## 什么是 MCP？\n\n模型上下文协议（MCP）是由 Anthropic 开发的开放标准，用于将 AI 助手连接到数据实际存储的系统，包括内容库、业务工具和开发环境。它作为一种通用协议，使 AI 系统能够安全且动态地实时与数据源交互。\n\n## 主要特性\n\n- **多 AI 平台支持**：兼容 ChatGPT、Perplexity、Google Gemini、Grok、Google AI Studio、OpenRouter Chat、DeepSeek、Kagi、T3 Chat、GitHub Copilot、Mistral AI、Kimi、Qwen Chat、Z Chat 等\n- **工具检测**：自动检测 AI 响应中的 MCP 工具调用\n- **工具执行**：只需单击即可执行 MCP 工具\n- **工具结果整合**：无缝将工具执行结果插入 AI 对话中\n- **渲染模式**：呈现函数调用及函数结果。\n- **自动执行模式**：自动执行检测到的工具\n- **自动提交模式**：在插入结果后自动提交聊天输入\n- **推送内容模式**：可选择推送页面内容而非叠加显示\n- **偏好设置持久化**：记住侧边栏位置、大小及设置\n- **深色\u002F浅色模式支持**：适配 AI 平台的主题\n\n```mermaid\nflowchart TD\n    A[AI 聊天界面] -->|生成| B[工具调用]\n    B -->|检测| C[扩展检测工具调用]\n    C -->|通过 SSE 发送| D[MCP 本地代理服务器]\n    D -->|转发| E[实际 MCP 服务器]\n    E -->|返回结果| D\n    D -->|返回结果| C\n    C -->|插入| F[将结果重新插入聊天]\n```\n\n### 连接到本地代理服务器\n\n要将 Chrome 扩展连接到本地服务器以代理连接，请按照以下步骤操作：\n\n#### 通过 npx 运行 MCP SuperAssistant 代理：\n\n1. 创建一个包含 MCP 服务器详细信息的 `config.json` 文件。例如，使用 [Desktop Commander](https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP)：\n\n   **示例 config.json：**\n   ```json\n   {\n     \"mcpServers\": {\n       \"desktop-commander\": {\n         \"command\": \"npx\",\n         \"args\": [\n           \"-y\",\n           \"@wonderwhy-er\u002Fdesktop-commander\"\n         ]\n       }\n     }\n   }\n   ```\n   `config.json` 文件还支持其他 MCP 服务器配置，如远程 MCP 服务器 URL。您可以尝试 Composio MCP、Zapier MCP、Smithery 或任何其他远程 MCP 服务器。\n\n   **或使用 Cursor 或其他工具已有的配置文件路径：**\n   ```\n   macOS: ~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json\n   Windows: %APPDATA%\\Claude\\claude_desktop_config.json\n   ```\n\n2. 使用以下任一命令启动 MCP SuperAssistant 代理服务器：\n\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy@latest --config .\u002Fconfig.json --outputTransport sse\n   ```\n   或\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy --config .\u002Fconfig.json --outputTransport streamableHttp\n   ```\n   或\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy --config .\u002Fconfig.json --outputTransport ws\n   ```\n\n   **查看所有可用选项：**\n   ```bash\n   npx -y @srbhptl39\u002Fmcp-superassistant-proxy@latest --help\n   ```\n\n   这对于以下场景非常有用：\n   - 代理远程 MCP 服务器\n   - 为远程服务器添加 CORS 支持\n   - 提供用于监控的健康端点\n\n#### 连接步骤：\n\n1. 使用上述任一命令启动代理服务器。\n2. 在支持的 AI 平台之一中打开 MCP SuperAssistant 侧边栏，此时应显示侧边栏界面。\n3. 点击服务器状态指示器（通常显示为“未连接”）。\n4. 输入本地服务器 URL（默认：`http:\u002F\u002Flocalhost:3006\u002Fsse`）。URL 格式取决于所使用的 `--outputTransport` 方法：\n   - 对于 SSE：`http:\u002F\u002Flocalhost:3006\u002Fsse`\n   - 对于 Streamable HTTP：`http:\u002F\u002Flocalhost:3006\u002Fmcp`\n   - 对于 WebSocket：`ws:\u002F\u002Flocalhost:3006\u002Fmessage`\n   - 选择合适的传输方法（SSE、Streamable HTTP 或 WebSocket）。\n   - 您也可以在此处添加任何远程 MCP 服务器 URL，前提是该服务器支持 CORS 或已通过此本地代理服务器进行代理。例如，[Composio MCP](https:\u002F\u002Fmcp.composio.dev\u002F)、[Zapier MCP](https:\u002F\u002Fzapier.com\u002Fmcp)、[Smithery](https:\u002F\u002Fsmithery.ai\u002F) 或其他远程 MCP 服务器。\n5. 点击“连接”以建立连接。\n6. 如果成功，状态指示器应变为“已连接”。\n\n## 使用方法\n示例工作流程：\n1. 导航到支持的 AI 平台，例如 ChatGPT。\n2. MCP SuperAssistant 侧边栏将出现在页面右侧。\n3. 配置您的 MCP 工具，启用或禁用您想要使用的工具。\n4. 在消息输入框区域，将鼠标悬停在“MCP”按钮上，即可查看可用工具及其描述。\n5. MCP SuperAssistant 需要在聊天中添加一条 MCP 工作指令提示，以说明其新功能及如何使用这些工具。使用“插入”或附件按钮添加该指令提示。\n6. 添加指令提示后，您可以要求它读取文件或执行任何相关的 MCP 工具操作。\n7. 当 AI 想要使用某个工具时，会显示一个自定义工具调用卡片，上面标明工具名称和参数。\n8. 用户可以手动点击工具调用卡片上的“运行”按钮来执行该工具调用；如果启用了自动执行模式，则会自动执行。\n9. 通过点击“MCP”按钮并配置自动执行和自动提交模式，可以实现自动化操作。\n\n## 小贴士与技巧\n\n1. **关闭搜索模式**（ChatGPT、Perplexity）在 AI 聊天界面中，以获得更好的工具调用提示体验，并防止 MCP SuperAssistant 被干扰。\n2. **开启推理模式**（ChatGPT、Perplexity、Grok）在 AI 聊天界面中，这将有助于 AI 更好地理解上下文并生成正确的工具调用。\n3. 使用较新的高端模型，因为它们更擅长理解上下文并生成正确的工具调用。\n4. 复制 MCP 指令提示并将其粘贴到 AI 聊天系统的提示中（例如 Google AI Studio）。\n5. 在对话中明确提及您想要使用的特定工具。\n6. 使用 MCP 自动切换功能来控制工具的执行。\n\n## MCP SuperAssistant 常见问题\n\n本页面涵盖了用户在使用 MCP SuperAssistant 时遇到的最常见问题，并提供了相应的解决方法。\n\n### 1. 扩展无法检测工具调用\n\n- 确保浏览器中已启用该扩展。\n- 确保在开始聊天之前，**MCP 指令提示已正确附加或插入**到聊天中。\n- 检查您的 AI 平台是否支持工具调用功能，并确认该功能已启用。\n- 如果问题仍然存在，请刷新页面或重启浏览器。\n\n### 2. 工具执行失败\n\n- 确保您的代理服务器正在运行，并且侧边栏服务器设置中的 URL 正确。\n- 检查您的 `config.json` 文件是否存在错误或格式问题。\n- 检查您的网络连接和防火墙设置。\n\n### 3. 连接问题\n\n- 确保您的 MCP 服务器正在运行且可访问。\n- 检查扩展设置中的服务器 URL。\n- 首先启动 npx mcp-SuperAssistant-proxy 代理服务器，然后从 `chrome:\u002F\u002Fextensions\u002F` 页面重新加载或重启扩展。\n- 检查代理服务器的日志，查看是否存在错误或问题。\n- 确保您的防火墙或杀毒软件没有阻止连接。\n- 确认服务器显示正确的连接状态，并暴露了 `\u002Fsse` 端口。\n\n### 4. 工具调用格式不正确\n\n- 有时模型不会按要求生成正确的工具调用格式，这会导致工具检测失败。在这种情况下，建议使用更适合工具调用或具有更好工具调用能力的模型。\n- 使用 MCP SuperAssistant 侧边栏中提供的自定义指令提示。\n- 在提示中明确要求使用相关工具。\n- 以下是 MCP 函数调用的正确格式示例，由 MCP SuperAssistant 扩展渲染：\n\n```\n```jsonl\n{\"type\": \"function_call_start\", \"name\": \"function_name\", \"call_id\": 1}\n{\"type\": \"description\", \"text\": \"简短的一句话，描述该函数的功能\"}\n{\"type\": \"parameter\", \"key\": \"parameter_1\", \"value\": \"value_1\"}\n{\"type\": \"parameter\", \"key\": \"parameter_2\", \"value\": \"value_2\"}\n{\"type\": \"function_call_end\", \"call_id\": 1}\n```\n```\n\n### 手动安装（开发）\n\n#### 发布版本\n1. 从 [Releases](https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Freleases) 下载最新发布版本\n2. 解压下载的文件\n3. 在 Chrome 浏览器中打开 `chrome:\u002F\u002Fextensions\u002F`\n4. 启用“开发者模式”\n5. 点击“加载已解压的扩展程序”，并选择解压后的目录\n6. 按照 [连接到本地代理服务器](#connecting-to-local-proxy-server) 的说明，连接到您的 MCP 服务器\n\n## 开发\n\n### 前提条件\n\n- Node.js (v16+) \n- pnpm\n\n### 设置\n\n```bash\n# 安装依赖\npnpm install\n\n# 启动开发服务器\npnpm dev\n\n# 构建生产环境\npnpm build\n\n# 创建用于分发的 zip 包\npnpm zip\n```\n\n## 贡献\n\n欢迎贡献！请随时提交 Pull Request。\n\n1. Fork 该仓库\n2. 创建你的功能分支 (`git checkout -b feature\u002Famazing-feature`)\n3. 提交你的更改 (`git commit -m '添加一些了不起的功能'`)\n4. 推送到该分支 (`git push origin feature\u002Famazing-feature`)\n5. 打开一个 Pull Request\n\n## 作者\n\n### [Saurabh Patel](https:\u002F\u002Fgithub.com\u002Fsrbhptl39)\n\n## 赞助与支持\n\n本项目完全在我的业余时间开发，源于我对 AI 和 Model Context Protocol (MCP) 的热情。作为一名全职从业者，要在工作和开源开发之间取得平衡，定期贡献并维持更新节奏颇具挑战性。\n\n您的支持将帮助我投入更多时间：\n- 🐛 修复 bug 和解决问题\n- ✨ 添加新功能及平台支持\n- 📚 改进文档和教程\n- 🔄 更新依赖项\n- 💬 回应社区需求\n\n**支持本项目：**\n- ⭐ 星标仓库以表达您的感谢\n- 💖 [在 GitHub 上赞助](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fsrbhptl39) 以帮助持续开发\n- 🐦 关注我在 [Twitter](https:\u002F\u002Ftwitter.com\u002Fsrbhptl39) (@srbhptl39) 的动态以获取最新信息\n- 📧 如需私人支持或定制实现，请通过 [Twitter](https:\u002F\u002Ftwitter.com\u002Fsrbhptl39) 联系我\n\n无论大小，每一份贡献都能让这个项目保持活力并不断进步！🙏\n\n## 许可证\n\n本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。\n\n## 致谢\n\n- 受 Anthropic 的 [Model Context Protocol (MCP)](https:\u002F\u002Fmodelcontextprotocol.io\u002F) 启发\n- 感谢 [Cline](https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline) 提供的想法灵感\n- 基于 [带有 React + Vite 的 Chrome 扩展模板](https:\u002F\u002Fgithub.com\u002FJonghakseo\u002Fchrome-extension-boilerplate-react-vite) 构建\n\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_readme_9ab125d80a1f.png)](https:\u002F\u002Fwww.star-history.com\u002F#srbhptl39\u002FMCP-SuperAssistant&Date)","# MCP-SuperAssistant 快速上手指南\n\nMCP-SuperAssistant 是一款浏览器扩展，旨在将 **Model Context Protocol (MCP)** 工具集成到 ChatGPT、Perplexity、Gemini、Kimi、GitHub Copilot 等主流 AI 平台中。它允许用户在网页版 AI 助手中直接检测和运行本地或远程的 MCP 工具，极大地扩展了 AI 的操作能力。\n\n## 环境准备\n\n在开始之前，请确保满足以下要求：\n\n*   **操作系统**：Windows, macOS 或 Linux。\n*   **浏览器**：已安装 Google Chrome 或 Mozilla Firefox 浏览器。\n*   **运行时环境**：已安装 **Node.js** (推荐 v18 及以上版本)，用于运行本地代理服务器。\n*   **AI 账号**：拥有任一受支持平台（如 ChatGPT, Kimi, Gemini 等）的访问权限。\n*   **MCP 服务配置**：准备好你的 MCP 服务器配置文件（`config.json`），例如用于文件操作的 `Desktop Commander` 或其他自定义服务。\n\n## 安装步骤\n\n### 1. 安装浏览器扩展\n\n选择以下任一方式安装扩展程序：\n\n*   **Chrome 用户**：访问 [Chrome Web Store](https:\u002F\u002Fchromewebstore.google.com\u002Fdetail\u002Fmcp-superassistant\u002Fkngiafgkdnlkgmefdafaibkibegkcaef) 点击“添加至 Chrome\"。\n*   **Firefox 用户**：访问 [Firefox Add-ons](https:\u002F\u002Faddons.mozilla.org\u002Fen-US\u002Ffirefox\u002Faddon\u002Fmcp-superassistant\u002F) 点击“添加到 Firefox\"。\n\n### 2. 配置并启动本地代理服务器\n\n扩展程序需要通过本地代理服务器与实际的 MCP 工具通信。\n\n**第一步：创建配置文件**\n\n在项目目录下创建 `config.json` 文件。以下是一个使用 `Desktop Commander`（桌面文件操作工具）的配置示例：\n\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@wonderwhy-er\u002Fdesktop-commander\"\n      ]\n    }\n  }\n}\n```\n> **提示**：你也可以直接使用现有工具的配置文件路径，例如 Cursor 的配置文件：\n> *   macOS: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n> *   Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**第二步：启动代理服务**\n\n在终端中运行以下命令启动代理服务器（推荐使用 SSE 传输模式）：\n\n```bash\nnpx -y @srbhptl39\u002Fmcp-superassistant-proxy@latest --config .\u002Fconfig.json --outputTransport sse\n```\n\n如果需要其他传输模式，可选：\n*   **Streamable HTTP**: `npx -y @srbhptl39\u002Fmcp-superassistant-proxy --config .\u002Fconfig.json --outputTransport streamableHttp`\n*   **WebSocket**: `npx -y @srbhptl39\u002Fmcp-superassistant-proxy --config .\u002Fconfig.json --outputTransport ws`\n\n保持该终端窗口运行，不要关闭。\n\n## 基本使用\n\n完成上述安装后，按照以下步骤即可在 AI 对话中使用 MCP 工具：\n\n### 1. 连接服务\n1.  打开受支持的 AI 网站（例如 [ChatGPT](https:\u002F\u002Fchatgpt.com\u002F) 或 [Kimi](https:\u002F\u002Fkimi.com\u002F)）。\n2.  页面右侧会出现 **MCP SuperAssistant** 侧边栏。\n3.  点击侧边栏顶部的状态指示器（默认显示为 \"Disconnected\"）。\n4.  输入本地服务器地址。根据启动命令选择的模式，地址如下：\n    *   SSE 模式（默认）：`http:\u002F\u002Flocalhost:3006\u002Fsse`\n    *   Streamable HTTP 模式：`http:\u002F\u002Flocalhost:3006\u002Fmcp`\n    *   WebSocket 模式：`ws:\u002F\u002Flocalhost:3006\u002Fmessage`\n5.  点击 **\"Connect\"**。当状态变为 **\"Connected\"** 且看到可用的工具列表时，表示连接成功。\n\n### 2. 注入指令\n为了让 AI 理解如何调用工具，需要将指令提示词注入到对话中：\n1.  在侧边栏中找到 **\"Insert\"** 或 **\"Attach\"** 按钮（通常位于工具列表附近）。\n2.  点击它将 MCP 工作指令提示词（Instructions Prompt）发送到聊天输入框。\n3.  发送该消息。这将告知 AI 当前具备的新能力及工具使用方法。\n\n### 3. 执行工具\n1.  在对话框中输入自然语言指令，例如：“读取我桌面上的 test.txt 文件”或“列出当前目录下的文件”。\n2.  AI 识别意图后，会生成一个特殊的 **工具调用卡片**（包含工具名称和参数）。\n3.  **手动模式**：点击卡片上的 **\"RUN\"** 按钮执行工具。\n4.  **自动模式**：在侧边栏设置中开启 **\"Auto-Execute\"**，AI 生成调用后将自动运行，并将结果返回给 AI 继续回答。\n\n### 使用小贴士\n*   **关闭搜索模式**：在 ChatGPT 或 Perplexity 中，建议暂时关闭联网搜索功能，以避免干扰工具调用的触发。\n*   **开启推理模式**：如果平台支持（如 o1 模型或 Grok 推理模式），开启后可提高工具调用的准确性。\n*   **明确指定工具**：在提示词中明确提到你想使用的工具名称，有助于 AI 更准确地生成调用格式。","某全栈开发者正在使用 Perplexity 进行遗留代码重构，需要实时读取本地数据库架构并调用内部 API 文档来生成准确的迁移脚本。\n\n### 没有 MCP-SuperAssistant 时\n- **数据孤岛严重**：AI 无法直接访问本地 SQLite 文件或内部 Wiki，开发者必须手动复制粘贴大量表结构和 API 定义到对话框中，极易出错且耗时。\n- **上下文断裂**：每次切换查询本地文件或测试接口后，都需要重新向 AI 描述当前状态，导致对话历史冗长且逻辑分散。\n- **操作繁琐低效**：为了验证 AI 生成的代码，开发者需在终端、浏览器和编辑器之间反复切换，手动执行命令并反馈结果，打断心流。\n- **安全风险不可控**：将敏感的本地数据结构或硬编码密钥复制到公共 AI 聊天窗口，存在潜在的数据泄露隐患。\n\n### 使用 MCP-SuperAssistant 后\n- **无缝连接本地资源**：直接在 Perplexity 或 ChatGPT 界面调用 MCP 工具，AI 可安全读取本地数据库架构和内部文档，无需任何手动复制。\n- **闭环工作流**：AI 能自动感知文件变更或 API 响应，基于实时上下文连续生成和优化代码，保持逻辑连贯性。\n- **一键执行与验证**：开发者可在聊天窗口直接触发本地命令运行测试脚本，AI 根据返回结果自动修正错误，实现“对话即开发”。\n- **隐私本地化保障**：敏感数据通过本地 MCP 服务器处理，仅将脱敏后的分析结果发送给大模型，确保核心资产不出内网。\n\nMCP-SuperAssistant 打破了网页版 AI 与本地开发环境的壁垒，让大模型真正具备了操作现实世界工具的能力。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsrbhptl39_MCP-SuperAssistant_469596fb.jpg","srbhptl39","Saurabh Patel","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsrbhptl39_bc86b900.jpg","Sr. Software Engineer \r\n@visa\r\nAI Engineer, CyberSecurity, DevOps",null,"Bengaluru India","srbhptl39@gmail.com","https:\u002F\u002Fgithub.com\u002Fsrbhptl39",[84,88,92,96],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",94.7,{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",4.5,{"name":93,"color":94,"percentage":95},"CSS","#663399",0.6,{"name":97,"color":98,"percentage":99},"Shell","#89e051",0.2,2388,316,"2026-04-05T15:56:58","MIT",1,"Windows, macOS, Linux","未说明",{"notes":108,"python":106,"dependencies":109},"该工具是一个浏览器扩展（支持 Chrome 和 Firefox），而非本地部署的 AI 模型，因此无特定 GPU、内存或 Python 版本要求。核心运行环境需安装 Node.js 以通过 npx 命令启动本地 MCP 代理服务器（mcp-superassistant-proxy）。用户需配置 config.json 文件来定义 MCP 服务器（如 Desktop Commander 或远程服务），并在浏览器扩展侧边栏中连接至本地代理地址（默认 http:\u002F\u002Flocalhost:3006\u002Fsse 等）。",[110,111,112],"Node.js (运行 npx)","@srbhptl39\u002Fmcp-superassistant-proxy","Chrome 浏览器或 Firefox 浏览器",[15],[115,116,117,118,119,120,121,122,123,124,125,126,127],"aistudio","assistant","chatgpt","gemini","google","grok","mcp","openrouter","perplexity","deepseek","kagi","qwen","t3","2026-03-27T02:49:30.150509","2026-04-06T07:14:10.166647",[],[132,137,142,147,152,157,162,167,172,177,182,187,192,197],{"id":133,"version":134,"summary_zh":135,"released_at":136},108649,"v0.6.0","任务：在 package.json 和 chrome-extension\u002Fpackage.json 中将版本号更新至 0.6.0；将 @modelcontextprotocol\u002Fsdk 降级至 1.20.2。\n修复：\n- 通义千问 MCP 按钮不可见\n- Perplexity UI 更新修复\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv.0.5.9...v0.6.0","2026-02-09T17:38:45",{"id":138,"version":139,"summary_zh":140,"released_at":141},108650,"v.0.5.9","任务：将 @modelcontextprotocol\u002Fsdk 升级到 1.25.2，将 zod 升级到 4.3.5\n\n修复：解决了 AIstudio 和 Openrouter 聊天中 MCP 按钮不显示的问题\n\n**完整更新日志**：https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv.0.5.8...v.0.5.9","2026-01-17T15:06:39",{"id":143,"version":144,"summary_zh":145,"released_at":146},108651,"v.0.5.8","- 修复 ChatGPT 功能名称和调用 ID\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.5.7...v.0.5.8","2025-11-03T14:31:18",{"id":148,"version":149,"summary_zh":150,"released_at":151},108652,"v0.5.7","\r\n- 将 @modelcontextprotocol\u002Fsdk 依赖升级至 1.20.2\n- 改进了 Grok 悬停交互\n- 新增基于 JSONL 的工具调用模式生成，对编码字符的处理可靠性更高\n- 修复了多项性能问题\n\n**完整更新日志**：https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.5.6...v0.5.7","2025-10-28T18:35:45",{"id":153,"version":154,"summary_zh":155,"released_at":156},108653,"v0.5.6","特性：将版本号升级至 0.5.6，并将 @modelcontextprotocol\u002Fsdk 依赖更新至 1.17.5\n\n- 将 @modelcontextprotocol\u002Fsdk 依赖从 1.13.1 升级至 1.17.5\n- 优化了 ChatGPTAdapter 和 OpenRouterAdapter，改进了按钮插入逻辑，并更新了聊天输入选择器，以更好地兼容新结构。","2025-09-07T17:41:59",{"id":158,"version":159,"summary_zh":160,"released_at":161},108654,"v0.5.5","新增对 [Z.ai](https:\u002F\u002Fchat.z.ai\u002F) 的支持\n新增对 [通义千问聊天](https:\u002F\u002Fchat.qwen.ai\u002F) 的支持\n修复了 Grok MCP 按钮问题\n其他 minor 修复\n\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.5.3-alpha...v0.5.5","2025-08-17T09:43:51",{"id":163,"version":164,"summary_zh":165,"released_at":166},108655,"v0.5.3-alpha","- 新增对 Kimi.com 的支持 :)\n- 对部分系统提示进行了优化\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.5.2-alpha...v0.5.3-alpha","2025-07-13T19:43:37",{"id":168,"version":169,"summary_zh":170,"released_at":171},108656,"v0.5.2-alpha","在侧边栏中新增了自动提交、自动执行和自动插入延迟设置面板。\n\n其他一些小修复：\n- 修复了 AI Studio 的删除按钮问题\n\n**完整更新日志**：https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.5.1-alpha...v0.5.2-alpha","2025-07-11T15:49:19",{"id":173,"version":174,"summary_zh":175,"released_at":176},108657,"v0.5.1-alpha","**完整更新日志**：https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.4.1-alpha...v0.5.1-alpha\n### 直接安装自\n[Chrome 网上应用店](https:\u002F\u002Fchromewebstore.google.com\u002Fdetail\u002Fmcp-superassistant\u002Fkngiafgkdnlkgmefdafaibkibegkcaef?hl=en)\n[Mozilla 附加组件商店](https:\u002F\u002Faddons.mozilla.org\u002Fen-US\u002Ffirefox\u002Faddon\u002Fmcp-superassistant\u002F)\n\n# 发布说明\n\n## 新特性\n- 引入了基于插件的新架构，以增强模块化和可扩展性。\n- 允许用户直接从侧边栏自定义选择工具，从而提升用户体验。\n- 增加了对可流式传输的 HTTP MCP 服务器的支持。\n- 集成了对基于 WebSocket 的 `mcp-superassistant-proxy` 连接的支持。\n- 实现了基于悬停的插入和附加功能，以加快交互速度。\n- 在底层优化了整体性能。\n\n## 平台支持\n- 新增对 [Mistral Chat](https:\u002F\u002Fchat.mistral.ai\u002Fchat) 的支持。\n- 新增对 [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Fcopilot) 的支持。\n\n## 修复与改进\n- 解决了多项稳定性问题。\n- 提升了连接可靠性。\n- 修复了导致侧边栏消失的问题。\n- 处理了可能导致崩溃的问题，以提供更稳定的使用体验。","2025-06-25T17:24:09",{"id":178,"version":179,"summary_zh":180,"released_at":181},108658,"v0.4.1-alpha","### 直接从以下地址安装：\n[Chrome 网上应用店](https:\u002F\u002Fchromewebstore.google.com\u002Fdetail\u002Fmcp-superassistant\u002Fkngiafgkdnlkgmefdafaibkibegkcaef?hl=en)  \n[Mozilla 附加组件商店](https:\u002F\u002Faddons.mozilla.org\u002Fen-US\u002Ffirefox\u002Faddon\u002Fmcp-superassistant\u002F)\n\n## 发布说明\n\n- 重构了主题检测逻辑，并改进了 MCP 处理器中的错误处理。\n- 更新了默认的 MCP 服务器 URL，统一使用 SSE 端点以确保各组件的一致性。\n- 优化了参数提取方式，移除了自动 JSON 解析，从而提升性能并避免意外转换。\n- 优化了可展开内容的过渡效果，改进了时序和高度计算。\n- 重构了 MCP 服务器可用性检查及连接状态处理逻辑，提升了可靠性和性能。\n- 增强了 ChatGPT 按钮插入逻辑，并优化了流式内容处理。\n- 移除了流式动画样式以提高性能。\n- 改进了可展开内容的渲染与样式。\n- 通过稳定性检查和流畅过渡，提升了流式传输和渲染性能。\n- 优化了样式和性能，进一步提升了流式体验。\n- 实现了针对函数调用和系统消息的可展开区域，并优化了相关样式。\n- 使用 CSS 自定义属性重构了浅色和深色主题的样式。\n- 对内容解析和 DOM 操作进行了性能优化。\n- 提升了 MutationObserver 和函数渲染的性能与效率。\n- 在重新连接时移除了不必要的保存进度覆盖层。\n- 在 InstructionManager 中新增了自定义指令处理和偏好设置管理功能。\n- 优化了侧边栏的动画和过渡效果，使用户体验更加流畅。\n- 改进了 MCP 客户端的错误处理和连接管理。\n- 更新了默认的 MCP 服务器 URL，并实现了传输方法的向后兼容。\n- 对侧边栏及其管理器进行了增强，增加了初始偏好设置处理和性能优化。\n- 改进了 MCP 界面和侧边栏，使其更好地支持服务器配置管理。\n\n## 简而言之\n\n- 改进了性能、错误处理和主题支持。\n- 增强了流式传输、侧边栏和可展开内容的功能。\n- 更新了服务器配置和偏好设置管理。\n- 修复了多个 bug，并优化了用户体验。\n- 修复了 JSON 解析问题。\n\n**额外修复：Firefox 的 CSS 加载问题**\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.3.1-alpha...v0.4.1-alpha","2025-05-30T21:20:37",{"id":183,"version":184,"summary_zh":185,"released_at":186},108659,"v0.3.1-alpha","## What's Changed\r\n* Perf issues by @srbhptl39 in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F48\r\n\r\n## What's Improved\r\n* Improved Connection related issues\r\n* User Driven Connection rather than automatic reconnection attempts for better stability\r\n* High Resource usage\r\n* SSE Connection stability\r\n* Tool Caching\r\n* Heartbeat response\r\n* Better feedback on the UI end\r\n\r\n## What's New\r\n* [Zapier](https:\u002F\u002Fmcp.zapier.com\u002F) and [Composio](https:\u002F\u002Fmcp.composio.dev\u002F) MCP SSE endpoint direct Support \r\n   - Get your configured URLs from these website's (other SSE sites might also work)\r\n   - Just place the SSE url in the server section of the extension itself 🔥 . Click Refresh.\r\n   - Benefits:\r\n      - Auth Handled\r\n      - No local server required\r\n      - Tools update on the fly using these endpoint\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.2.1-alpha...v0.2.2-alpha","2025-05-22T07:23:49",{"id":188,"version":189,"summary_zh":190,"released_at":191},108660,"v0.2.1-alpha","### Added Support for \r\n1. Kagi.com- https:\u002F\u002Fkagi.com\u002Fassistant\u002F\r\n2. T3 Chat - https:\u002F\u002Ft3.chat\u002F\r\n3. Deepseek - https:\u002F\u002Fchat.deepseek.com\u002F\r\n\r\n### UI Enhancements\r\nRender the **function_results** and **system message** as a proper UI just like function calls. 🔥\r\n\r\n### Other Stabilization fixes\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.1.2-alpha...v0.2.1-alpha","2025-05-19T18:02:28",{"id":193,"version":194,"summary_zh":195,"released_at":196},108661,"v0.1.2-alpha","## What's Changed\r\n* fix: prevent duplicate tool execution listeners for adapters by @hayeah in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F28\r\n* fix: replace pnpx with pnpm dlx for cross-platform compatibility by @hayeah in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F26\r\n* Fix: Update selectors for Gemini submit button and AiStudio chat input by @k0vah1911pepsi in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F36\r\n\r\n## New Contributors\r\n* @hayeah made their first contribution in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F28\r\n* @k0vah1911pepsi made their first contribution in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F36\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcompare\u002Fv0.1.1-alpha...v0.1.2-alpha","2025-05-14T15:48:45",{"id":198,"version":199,"summary_zh":200,"released_at":201},108662,"v0.1.1-alpha","Added Supports for\r\n - ChatGPT\r\n - Grok\r\n - Perplexity\r\n - Gemini\r\n - Google AI Studio\r\n - Added OpenRouter Chat (https:\u002F\u002Fopenrouter.ai\u002Fchat) [New]\r\n\r\n## What's Changed\r\n* build(deps-dev): Bump eslint-import-resolver-typescript from 4.2.7 to 4.3.4 by @dependabot in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F2\r\n\r\n## New Contributors\r\n* @dependabot made their first contribution in https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fpull\u002F2\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsrbhptl39\u002FMCP-SuperAssistant\u002Fcommits\u002Fv0.1.1-alpha","2025-05-02T17:58:35"]