[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-ravitemer--mcphub.nvim":3,"tool-ravitemer--mcphub.nvim":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},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 真正成长为懂上",145895,2,"2026-04-08T11:32:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":73,"owner_company":73,"owner_location":75,"owner_email":73,"owner_twitter":72,"owner_website":73,"owner_url":76,"languages":77,"stars":90,"forks":91,"last_commit_at":92,"license":93,"difficulty_score":32,"env_os":94,"env_gpu":95,"env_ram":95,"env_deps":96,"category_tags":102,"github_topics":103,"view_count":32,"oss_zip_url":73,"oss_zip_packed_at":73,"status":17,"created_at":120,"updated_at":121,"faqs":122,"releases":151},5663,"ravitemer\u002Fmcphub.nvim","mcphub.nvim","An MCP client for Neovim that seamlessly integrates MCP servers into your editing workflow with an intuitive interface for managing, testing, and using MCP servers with your favorite chat plugins.","mcphub.nvim 是一款专为 Neovim 打造的 MCP（模型上下文协议）客户端插件。它旨在打破编辑器与外部 AI 服务之间的壁垒，让用户能在熟悉的编码环境中无缝连接、管理和测试各类 MCP 服务器。\n\n对于依赖 AI 辅助编程的开发者而言，以往配置和切换不同的 AI 工具往往需要繁琐的外部设置或复杂的命令行操作。mcphub.nvim 通过提供直观的交互界面，将这一过程简化为编辑器内的自然工作流。用户可以直接在 Neovim 中调用 MCP 服务器提供的工具、资源和提示词（Prompts），并与其常用的聊天插件深度集成，从而实现更流畅的人机协作体验。\n\n这款工具特别适合热衷于定制开发环境的程序员、技术研究人员以及重度 Neovim 用户。其核心技术亮点在于对 MCP 协议特性的全面支持，包括工具调用、资源管理及模板化提示词，并具备实时监听服务器列表变化的能力，确保状态同步零延迟。基于 Lua 编写且遵循 MIT 协议，mcphub.nvim 以轻量、灵活的方式，帮助开发者将强大的 AI 上下文能力直接融入代码编辑的每一个环节。","\u003Cdiv align=\"center\" markdown=\"1\">\n   \u003Csup>Special thanks to:\u003C\u002Fsup>\n   \u003Cbr>\n   \u003Cbr>\n   \u003Ca href=\"https:\u002F\u002Fwww.warp.dev\u002Fmcp-hub-nvim\">\n      \u003Cimg alt=\"Warp sponsorship\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_a00c4876c0d4.png\">\n   \u003C\u002Fa>\n\n### [The Intelligent Terminal](https:\u002F\u002Fwww.warp.dev\u002Fmcp-hub-nvim)\n\n[Run mcphub.nvim in Warp today](https:\u002F\u002Fwww.warp.dev\u002Fmcp-hub-nvim)\u003Cbr>\n\n\u003C\u002Fdiv>\n\u003Chr>\n\n\u003Cdiv align=\"center\" markdown=\"1\">\n\u003Ch1> \u003Cimg width=\"28px\" style=\"display:inline;\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_e891cf586d05.png\"\u002F> MCP HUB\u003C\u002Fh1>\n\n[![Lua](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLua-2C2D72?style=flat-square&logo=lua&logoColor=white)](https:\u002F\u002Fwww.lua.org)\n[![NixOS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNixOS-5277C3?style=flat-square&logo=nixos&logoColor=white)](https:\u002F\u002Fnixos.org)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-7289DA?style=flat-square&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FNTqfxXsNuN)\n\u003C\u002Fdiv>\n\nMCP Hub is a MCP client for neovim that seamlessly integrates [MCP (Model Context Protocol)](https:\u002F\u002Fmodelcontextprotocol.io\u002F) servers into your editing workflow. It provides an intuitive interface for managing, testing, and using MCP servers with your favorite chat plugins.\n\n![Image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_994c2fd1c3de.png)\n\n## 💜 Sponsors\n\n\u003C!-- sponsors --> \u003Cp align=\"center\"> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FCryogenicPlanet\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_bcf55477ef14.png\" width=\"50px\" alt=\"CryogenicPlanet\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Folimorris\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_fb60e2a37c3c.png\" width=\"50px\" alt=\"Oli Morris\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsupermemoryai\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_e2c0fdab637e.png\" width=\"50px\" alt=\"Super Memory\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyingmanwumen\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_b618d0f4fa29.png\" width=\"50px\" alt=\"yingmanwumen\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyetone\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_32d8c3e63905.png\" width=\"50px\" alt=\"Yetone\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fomarcresp\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_915d6f110fb6.png\" width=\"50px\" alt=\"omarcresp\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpetermoser\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_53928a10a630.png\" width=\"50px\" alt=\"petermoser\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fwatsy0007\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_388e50711ebc.png\" width=\"50px\" alt=\"watsy0007\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fkohane27\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_a952e4676a99.png\" width=\"50px\" alt=\"kohane27\" \u002F>\u003C\u002Fa>  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcopleykj\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_045983fd69e2.png\" width=\"50px\" alt=\"Kelly Copley\" \u002F>\u003C\u002Fa>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnom-social\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_65a82aacec8d.png\" width=\"50px\" alt=\"Nom Social\" \u002F>\u003C\u002Fa>\u003C\u002Fp>\u003C!-- sponsors -->\n\n\u003Cp align=\"center\">\n  \u003Cb>Special thanks to:\u003C\u002Fb> \n\u003C\u002Fp>\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fdub.sh\u002Fcomposio-mcp\" target=\"_blank\"> \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_dd78f7eb74f8.png\" height=\"60px\" alt=\"Composio.dev logo\" \u002F>  \u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fvapi.ai\" target=\"_blank\"> \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_7bd21e7f8f6b.png\" height=\"60px\" alt=\"Vapi logo\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n## ✨ Features \n\n| Category | Feature | Support | Details |\n|----------|---------|---------|-------|\n| [**Capabilities**](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fserver) ||||\n| | Tools | ✅ | Full support |\n| | 🔔 Tool List Changed | ✅ | Real-time updates |\n| | Resources | ✅ | Full support |\n| | 🔔 Resource List Changed | ✅ | Real-time updates |\n| | Resource Templates | ✅ | URI templates |\n| | Prompts | ✅ | Full support |\n| | 🔔 Prompts List Changed | ✅ | Real-time updates |\n| | Roots | ❌ | Not supported |\n| | Sampling | ❌ | Not supported |\n| **MCP Server Transports** ||||\n| | [Streamable-HTTP](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Ftransports#streamable-http) | ✅ | Primary transport protocol for remote servers |\n| | [SSE](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Ftransports#backwards-compatibility) | ✅ | Fallback transport for remote servers |\n| | [STDIO](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Ftransports#stdio) | ✅ | For local servers |\n| **Authentication for remote servers** ||||\n| | [OAuth](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Fauthorization) | ✅ | With PKCE flow |\n| | Headers | ✅ | For API keys\u002Ftokens |\n| **Chat Integration** ||||\n| | [Avante.nvim](https:\u002F\u002Fgithub.com\u002Fyetone\u002Favante.nvim) | ✅ | Tools, resources, resourceTemplates, prompts(as slash_commands) |\n| | [CodeCompanion.nvim](https:\u002F\u002Fgithub.com\u002Folimorris\u002Fcodecompanion.nvim) | ✅ | Tools, resources, templates, prompts (as slash_commands), 🖼 image responses | \n| | [CopilotChat.nvim](https:\u002F\u002Fgithub.com\u002FCopilotC-Nvim\u002FCopilotChat.nvim) | ✅ | Tools, resources, function calling support |\n| **Marketplace** ||||\n| | Server Discovery | ✅ | Browse from verified MCP servers |\n| | Installation | ✅ | Manual and auto install with AI |\n| **Configuration** ||||\n| | Universal `${}` Syntax | ✅ | Environment variables and command execution across all fields |\n| | VS Code Compatibility | ✅ | Support for `servers` key, `${env:}`, `${input:}`, predefined variables |\n| | JSON5 Support | ✅ | Comments and trailing commas via [`lua-json5`](https:\u002F\u002Fgithub.com\u002FJoakker\u002Flua-json5) |\n| **Workspace Management** ||||\n| | Project-Local Configs | ✅ | Automatic detection and merging with global config |\n| **Advanced** ||||\n| | Smart File-watching | ✅ | Smart updates with config file watching |\n| | Multi-instance | ✅ | All neovim instances stay in sync |\n| | Shutdown-delay | ✅ | Can run as systemd service with configure delay before stopping the hub |\n| | Lua Native MCP Servers | ✅ | Write once , use everywhere. Can write tools, resources, prompts directly in lua |\n| | Dev Mode | ✅ | Hot reload MCP servers on file changes for development |\n\n## 🎥 Demos\n\n\u003Cdiv align=\"center\">\n\u003Ch4>MCP Hub + \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Folimorris\u002Fcodecompanion.nvim\">CodeCompanion\u003C\u002Fa> + Github \u003C\u002Fh4>\n\u003Cp>\n\u003Cvideo muted controls src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1a10ad50-5832-4627-bcc3-be49e7941105\">\u003C\u002Fvideo>\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\n\u003Cdiv align=\"center\">\n\u003Cp>\n\u003Ch4>MCP Hub + \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyetone\u002Favante.nvim\">Avante\u003C\u002Fa> + Figma \u003C\u002Fh4>\n\u003Cvideo controls muted src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fe33fb5c3-7dbd-40b2-bec5-471a465c7f4d\">\u003C\u002Fvideo>\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\n\n## 🚀 Getting Started\n\nVisit our [documentation site](https:\u002F\u002Fravitemer.github.io\u002Fmcphub.nvim\u002F) for detailed guides and examples\n\n## 👋 Get Help\n\n- Check out the [Troubleshooting guide](https:\u002F\u002Fravitemer.github.io\u002Fmcphub.nvim\u002Ftroubleshooting)\n- Join our [Discord server](https:\u002F\u002Fdiscord.gg\u002FNTqfxXsNuN) for discussions, help, and updates\n\n## :gift: Contributing\n\nPlease read the [CONTRIBUTING.md](CONTRIBUTING.md) guide.\n\n## 🚧 TODO\n\n- [x] Neovim MCP Server (kind of) with better editing, diffs, terminal integration etc (Ideas are welcome)\n- [x] Enhanced help view with comprehensive documentation\n- [x] MCP Resources as variables in chat plugins\n- [x] MCP Prompts as slash commands in chat plugins\n- [x] Enable LLM to start and stop MCP Servers dynamically\n- [x] Support SSE transport\n- [x] Support \u002Fslash_commands in avante\n- [x] Support streamable-http transport\n- [x] Support OAuth\n- [x] Add types\n- [x] Better Docs \n- [ ] Add tests\n- [ ] Support #variables in avante\n\n\n## 👏 Acknowledgements\n\nThanks to:\n\n- [nui.nvim](https:\u002F\u002Fgithub.com\u002FMunifTanjim\u002Fnui.nvim) for inspiring our text highlighting utilities\n- [ravitemer\u002Fmcp-registry](https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcp-registry) for providing the marketplace api\n\n","\u003Cdiv align=\"center\" markdown=\"1\">\n   \u003Csup>特别感谢：\u003C\u002Fsup>\n   \u003Cbr>\n   \u003Cbr>\n   \u003Ca href=\"https:\u002F\u002Fwww.warp.dev\u002Fmcp-hub-nvim\">\n      \u003Cimg alt=\"Warp赞助\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_a00c4876c0d4.png\">\n   \u003C\u002Fa>\n\n### [智能终端](https:\u002F\u002Fwww.warp.dev\u002Fmcp-hub-nvim)\n\n[立即在Warp中运行mcphub.nvim](https:\u002F\u002Fwww.warp.dev\u002Fmcp-hub-nvim)\u003Cbr>\n\n\u003C\u002Fdiv>\n\u003Chr>\n\n\u003Cdiv align=\"center\" markdown=\"1\">\n\u003Ch1> \u003Cimg width=\"28px\" style=\"display:inline;\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_e891cf586d05.png\"\u002F> MCP HUB\u003C\u002Fh1>\n\n[![Lua](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLua-2C2D72?style=flat-square&logo=lua&logoColor=white)](https:\u002F\u002Fwww.lua.org)\n[![NixOS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNixOS-5277C3?style=flat-square&logo=nixos&logoColor=white)](https:\u002F\u002Fnixos.org)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-7289DA?style=flat-square&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FNTqfxXsNuN)\n\u003C\u002Fdiv>\n\nMCP Hub 是一个适用于 Neovim 的 MCP 客户端，可将 [MCP（模型上下文协议）](https:\u002F\u002Fmodelcontextprotocol.io\u002F) 服务器无缝集成到你的编辑工作流中。它提供了一个直观的界面，用于管理、测试和使用你最喜欢的聊天插件中的 MCP 服务器。\n\n![图片](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_994c2fd1c3de.png)\n\n## 💜 赞助商\n\n\u003C!-- sponsors --> \u003Cp align=\"center\"> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FCryogenicPlanet\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_bcf55477ef14.png\" width=\"50px\" alt=\"CryogenicPlanet\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Folimorris\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_fb60e2a37c3c.png\" width=\"50px\" alt=\"Oli Morris\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsupermemoryai\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_e2c0fdab637e.png\" width=\"50px\" alt=\"Super Memory\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyingmanwumen\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_b618d0f4fa29.png\" width=\"50px\" alt=\"yingmanwumen\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyetone\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_32d8c3e63905.png\" width=\"50px\" alt=\"Yetone\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fomarcresp\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_915d6f110fb6.png\" width=\"50px\" alt=\"omarcresp\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpetermoser\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_53928a10a630.png\" width=\"50px\" alt=\"petermoser\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fwatsy0007\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_388e50711ebc.png\" width=\"50px\" alt=\"watsy0007\" \u002F>\u003C\u002Fa> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fkohane27\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_a952e4676a99.png\" width=\"50px\" alt=\"kohane27\" \u002F>\u003C\u002Fa>  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcopleykj\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_045983fd69e2.png\" width=\"50px\" alt=\"Kelly Copley\" \u002F>\u003C\u002Fa>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnom-social\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_65a82aacec8d.png\" width=\"50px\" alt=\"Nom Social\" \u002F>\u003C\u002Fa>\u003C\u002Fp>\u003C!-- sponsors -->\n\n\u003Cp align=\"center\">\n  \u003Cb>特别感谢：\u003C\u002Fb> \n\u003C\u002Fp>\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fdub.sh\u002Fcomposio-mcp\" target=\"_blank\"> \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_dd78f7eb74f8.png\" height=\"60px\" alt=\"Composio.dev logo\" \u002F>  \u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fvapi.ai\" target=\"_blank\"> \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_readme_7bd21e7f8f6b.png\" height=\"60px\" alt=\"Vapi logo\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n## ✨ 功能 \n\n| 类别 | 功能 | 支持 | 详情 |\n|----------|---------|---------|-------|\n| [**能力**](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fserver) ||||\n| | 工具 | ✅ | 完全支持 |\n| | 🔔 工具列表变更 | ✅ | 实时更新 |\n| | 资源 | ✅ | 完全支持 |\n| | 🔔 资源列表变更 | ✅ | 实时更新 |\n| | 资源模板 | ✅ | URI 模板 |\n| | 提示 | ✅ | 完全支持 |\n| | 🔔 提示列表变更 | ✅ | 实时更新 |\n| | 根 | ❌ | 不支持 |\n| | 采样 | ❌ | 不支持 |\n| **MCP 服务器传输方式** ||||\n| | [可流式HTTP](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Ftransports#streamable-http) | ✅ | 远程服务器的主要传输协议 |\n| | [SSE](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Ftransports#backwards-compatibility) | ✅ | 远程服务器的备用传输方式 |\n| | [STDIO](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Ftransports#stdio) | ✅ | 用于本地服务器 |\n| **远程服务器的身份验证** ||||\n| | [OAuth](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002F2025-03-26\u002Fbasic\u002Fauthorization) | ✅ | 带 PKCE 流程 |\n| | 头部信息 | ✅ | 用于 API 密钥\u002F令牌 |\n| **聊天集成** ||||\n| | [Avante.nvim](https:\u002F\u002Fgithub.com\u002Fyetone\u002Favante.nvim) | ✅ | 工具、资源、资源模板、提示（作为 slash_commands） |\n| | [CodeCompanion.nvim](https:\u002F\u002Fgithub.com\u002Folimorris\u002Fcodecompanion.nvim) | ✅ | 工具、资源、模板、提示（作为 slash_commands）、🖼 图像响应 | \n| | [CopilotChat.nvim](https:\u002F\u002Fgithub.com\u002FCopilotC-Nvim\u002FCopilotChat.nvim) | ✅ | 工具、资源、函数调用支持 |\n| **市场** ||||\n| | 服务器发现 | ✅ | 可浏览经过验证的 MCP 服务器 |\n| | 安装 | ✅ | 手动安装以及借助 AI 自动安装 |\n| **配置** ||||\n| | 通用 `${}` 语法 | ✅ | 环境变量及命令执行贯穿所有字段 |\n| | VS Code 兼容性 | ✅ | 支持 `servers` 键、`${env:}`、`${input:}` 以及预定义变量 |\n| | JSON5 支持 | ✅ | 通过 [`lua-json5`](https:\u002F\u002Fgithub.com\u002FJoakker\u002Flua-json5) 支持注释和尾随逗号 |\n| **工作区管理** ||||\n| | 项目本地配置 | ✅ | 自动检测并与全局配置合并 |\n| **高级功能** ||||\n| | 智能文件监听 | ✅ | 通过监听配置文件实现智能更新 |\n| | 多实例 | ✅ | 所有 Neovim 实例保持同步 |\n| | 关机延迟 | ✅ | 可以作为 systemd 服务运行，并在停止中心之前设置延迟 |\n| | Lua 原生 MCP 服务器 | ✅ | 一次编写，处处可用。可以直接用 Lua 编写工具、资源和提示 |\n| | 开发模式 | ✅ | 文件更改时热重载 MCP 服务器，便于开发 |\n\n## 🎥 演示\n\n\u003Cdiv align=\"center\">\n\u003Ch4>MCP Hub + \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Folimorris\u002Fcodecompanion.nvim\">CodeCompanion\u003C\u002Fa> + Github \u003C\u002Fh4>\n\u003Cp>\n\u003Cvideo muted controls src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1a10ad50-5832-4627-bcc3-be49e7941105\">\u003C\u002Fvideo>\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\n\u003Cdiv align=\"center\">\n\u003Cp>\n\u003Ch4>MCP Hub + \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyetone\u002Favante.nvim\">Avante\u003C\u002Fa> + Figma \u003C\u002Fh4>\n\u003Cvideo controls muted src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fe33fb5c3-7dbd-40b2-bec5-471a465c7f4d\">\u003C\u002Fvideo>\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\n\n## 🚀 快速入门\n\n访问我们的 [文档网站](https:\u002F\u002Fravitemer.github.io\u002Fmcphub.nvim\u002F) 获取详细指南和示例\n\n## 👋 获取帮助\n\n- 查看 [故障排除指南](https:\u002F\u002Fravitemer.github.io\u002Fmcphub.nvim\u002Ftroubleshooting)\n- 加入我们的 [Discord 服务器](https:\u002F\u002Fdiscord.gg\u002FNTqfxXsNuN) 进行讨论、获取帮助和了解最新动态\n\n## :gift: 贡献\n\n请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 指南。\n\n## 🚧 待办事项\n\n- [x] Neovim MCP 服务器（某种程度上）：改进编辑功能、差异对比、终端集成等（欢迎提出想法）\n- [x] 增强的帮助视图，包含全面的文档\n- [x] 将 MCP 资源作为聊天插件中的变量\n- [x] 将 MCP 提示作为聊天插件中的斜杠命令\n- [x] 允许 LLM 动态启动和停止 MCP 服务器\n- [x] 支持 SSE 传输协议\n- [x] 在 avante 中支持 \u002Fslash_commands\n- [x] 支持可流式传输的 HTTP 传输协议\n- [x] 支持 OAuth\n- [x] 添加类型定义\n- [x] 完善文档\n- [ ] 添加测试\n- [ ] 在 avante 中支持 #variables\n\n\n## 👏 致谢\n\n感谢以下项目：\n\n- [nui.nvim](https:\u002F\u002Fgithub.com\u002FMunifTanjim\u002Fnui.nvim)：启发了我们的文本高亮工具\n- [ravitemer\u002Fmcp-registry](https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcp-registry)：提供了市场 API","# mcphub.nvim 快速上手指南\n\n`mcphub.nvim` 是一个专为 Neovim 设计的 MCP (Model Context Protocol) 客户端。它能无缝集成 MCP 服务器到你的编辑工作流中，提供直观的界面来管理、测试和使用 MCP 服务，并支持与 Avante、CodeCompanion、CopilotChat 等主流 AI 聊天插件联动。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **Neovim**: 版本 >= 0.9.0 (推荐最新稳定版)。\n*   **Lua**: 内置于 Neovim，无需单独安装。\n*   **依赖插件**:\n    *   `nui.nvim`: 用于构建 UI 界面（通常由 `mcphub.nvim` 自动处理或需手动安装，建议通过包管理器一并安装）。\n*   **MCP 服务器**: 根据你需要使用的功能，提前准备好相应的 MCP 服务器环境（如 Node.js, Python 等运行时）。\n*   **网络环境**: 如果使用远程 MCP 服务器或市场功能，请确保网络畅通。国内用户若遇到连接 GitHub 或外部源缓慢的情况，建议配置合适的网络代理。\n\n## 安装步骤\n\n推荐使用 Lua 包管理器（如 `lazy.nvim`）进行安装。\n\n### 1. 使用 lazy.nvim 安装\n\n在你的 Neovim 插件配置文件中（通常是 `~\u002F.config\u002Fnvim\u002Flua\u002Fplugins\u002Fmcphub.lua` 或类似位置），添加以下配置：\n\n```lua\nreturn {\n  \"ravitemer\u002Fmcphub.nvim\",\n  dependencies = {\n    \"MunifTanjim\u002Fnui.nvim\",\n    \"nvim-lua\u002Fplenary.nvim\", -- 可选，部分功能可能需要\n  },\n  config = function()\n    require(\"mcphub\").setup({\n      -- 在这里添加你的自定义配置\n      -- 例如：启用市场功能、配置日志级别等\n    })\n  end,\n}\n```\n\n### 2. 重新加载配置\n\n安装完成后，重启 Neovim 或在命令模式下执行 `:source %` (如果在配置文件中) 或 `:Lazy sync` 来同步并加载插件。\n\n## 基本使用\n\n安装完成后，你可以通过以下步骤快速开始使用：\n\n### 1. 打开 MCP Hub 界面\n\n在 Neovim 正常模式下，输入以下命令打开主界面：\n\n```vim\n:McpHub\n```\n\n该界面将显示已连接的服务器状态、可用工具 (Tools)、资源 (Resources) 和提示词 (Prompts)。\n\n### 2. 配置 MCP 服务器\n\n`mcphub.nvim` 支持多种配置方式，包括本地 JSON\u002FJSON5 配置文件。\n\n创建一个配置文件（例如 `~\u002F.config\u002Fnvim\u002Fmcp.json` 或项目根目录下的 `.mcp.json`），添加服务器定义：\n\n```json5\n{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Fpath\u002Fto\u002Fyour\u002Fproject\"]\n    },\n    \"github\": {\n      \"command\": \"node\",\n      \"args\": [\"\u002Fpath\u002Fto\u002Fgithub-mcp-server\u002Fbuild\u002Findex.js\"],\n      \"env\": {\n        \"GITHUB_TOKEN\": \"${env:GITHUB_TOKEN}\" \u002F\u002F 支持环境变量\n      }\n    }\n  }\n}\n```\n\n*注：插件支持 `${env:VAR}` 语法读取环境变量，也支持 JSON5 格式（允许注释和尾随逗号）。*\n\n配置保存后，Hub 界面通常会自动热重载，或通过命令 `:McpHubReloadConfig` 手动刷新。\n\n### 3. 与 AI 聊天插件联动\n\n这是 `mcphub.nvim` 的核心功能。配置好服务器后，它会自动桥接至支持的聊天插件：\n\n*   **Avante.nvim**: MCP Tools 可直接调用，Prompts 可作为 `\u002F` 斜杠命令使用。\n*   **CodeCompanion.nvim**: 支持 Tools、Resources 以及图片响应。\n*   **CopilotChat.nvim**: 支持函数调用 (Function Calling)。\n\n**示例场景**：\n在安装了 `github` MCP 服务器后，打开 `CodeCompanion` 或 `Avante` 的聊天窗口，直接询问：“列出当前仓库最近的 Issues\"，AI 将自动调用 MCP 工具获取数据并回答，无需手动复制粘贴。\n\n### 4. 浏览和安装服务器 (市场功能)\n\n在 `:McpHub` 界面中，你可以访问内置的市场 (Marketplace)：\n\n1.  进入市场视图。\n2.  浏览经过验证的 MCP 服务器列表。\n3.  选择需要的服务器，插件支持一键安装（需满足对应运行环境）或生成配置模板。\n\n---\n*更多高级配置（如 OAuth 认证、多实例同步、Lua 原生编写服务器等），请参阅官方文档。*","一位后端开发者正在 Neovim 中重构微服务架构，需要频繁调用本地数据库查询工具、读取分布式日志资源，并让 AI 助手基于实时上下文生成代码。\n\n### 没有 mcphub.nvim 时\n- **配置割裂且繁琐**：开发者需在终端手动启动多个 MCP 服务器，并在不同的聊天插件配置文件中硬编码连接信息，每次新增工具都要重启编辑器。\n- **状态黑盒难以调试**：无法直观看到哪些资源（Resources）或提示词（Prompts）已加载，当 AI 无法调用预期工具时，只能翻阅晦涩的日志文件排查连接故障。\n- **响应滞后影响流**：当后端服务更新导致可用工具列表变化时，编辑器无法感知，开发者必须手动重载配置才能同步最新的能力列表，打断心流。\n- **交互体验不统一**：管理服务器、测试工具参数和实际对话分散在不同窗口，缺乏统一的界面来预览和验证 MCP 服务器的具体能力。\n\n### 使用 mcphub.nvim 后\n- **一站式无缝集成**：直接在 Neovim 内通过直观界面管理所有 MCP 服务器，无需离开编辑器即可配置、启动并与喜爱的聊天插件自动对接。\n- **可视化实时监控**：提供清晰的面板展示已加载的工具、资源和提示词列表，支持实时查看状态变更，故障排查从“猜谜”变为“可视”。\n- **动态热更新支持**：借助对工具列表和资源变更的实时监听，一旦后端服务更新接口，mcphub.nvim 立即同步最新能力，确保 AI 始终基于最新上下文工作。\n- **闭环测试与管理**：内置测试功能允许开发者在调用前直接验证工具参数和返回值，将服务器管理、能力测试与代码生成整合在同一工作流中。\n\nmcphub.nvim 通过将复杂的 MCP 协议转化为 Neovim 原生的可视化工作流，让开发者从繁琐的配置管理中解放，专注于真正的智能编码协作。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fravitemer_mcphub.nvim_994c2fd1.png","ravitemer",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fravitemer_82945700.jpg","India","https:\u002F\u002Fgithub.com\u002Fravitemer",[78,82,86],{"name":79,"color":80,"percentage":81},"Lua","#000080",99.7,{"name":83,"color":84,"percentage":85},"Makefile","#427819",0.2,{"name":87,"color":88,"percentage":89},"Nix","#7e7eff",0.1,1757,81,"2026-04-08T09:23:05","MIT","Linux, macOS, Windows","未说明",{"notes":97,"python":95,"dependencies":98},"该工具是 Neovim 的 Lua 插件，用于集成 MCP (Model Context Protocol) 服务器。核心运行环境为 Neovim，无需独立的 Python 环境或 GPU 资源（除非调用的具体 MCP 服务器有额外需求）。支持通过 systemd 服务运行，并兼容 VS Code 风格的配置文件语法及 JSON5 格式。",[99,100,101],"Neovim (需支持 Lua)","lua-json5","nui.nvim (间接依赖)",[35,52,14],[104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119],"avante","chatgpt","chatplugin","claude-ai","llm","mcp","mcp-client","mcp-hub","mcp-server","mcp-servers","model-context-protocol","neovim","neovim-plugin","nvim","nvim-plugin","codecompanion","2026-03-27T02:49:30.150509","2026-04-09T05:23:54.563507",[123,128,133,138,143,147],{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},25691,"为什么 Marketplace（市场）显示为空或找不到任何服务器？","这是因为原来的 Cline Marketplace 引入了身份验证机制，导致无法直接访问。解决方案是迁移到新的市场注册表。请更新配置以使用新的 `mcp-registry` 市场地址：https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcp-registry。维护者已发布相关更新修复此问题。","https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcphub.nvim\u002Fissues\u002F24",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},25692,"在 WSL (Ubuntu) 中启动时遇到 \"Server error (502)\" 错误怎么办？","这通常是由于代理设置干扰了本地连接导致的。即使服务器已启动，代理也可能拦截对 localhost 的请求。解决方法是设置 `NO_PROXY` 环境变量，明确指定不需要代理的地址：\n\n```bash\nexport NO_PROXY=\"localhost,127.0.0.1\"\n```\n\n设置后重启终端或 Neovim 即可解决。","https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcphub.nvim\u002Fissues\u002F87",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},25693,"加载 CodeCompanion 扩展时报错 \"module 'mcphub.extensions.codecompanion' not found\" 如何解决？","这通常是因为 MCPHub 插件尚未加载，而 CodeCompanion 试图调用其扩展模块。确保在配置中正确设置了懒加载命令。如果你希望在使用 CodeCompanion 命令时自动激活 MCPHub，需要在 MCPHub 的配置中添加 `cmd` 选项，或者确保 CodeCompanion 的命令触发器包含 MCPHub 的初始化逻辑。例如，确保 MCPHub 在 CodeCompanion 之前就绪，或者通过 `cmd = \"MCPHub\"` 显式加载。","https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcphub.nvim\u002Fissues\u002F4",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},25694,"Marketplace 显示 \"404\" 错误是什么原因？","该问题与 `shutdown_delay` 选项有关，在某些情况下会导致连接异常。维护者建议禁用或删除该选项以避免此问题。在新版本提交中，维护者已经移除了 `shutdown_delay` 选项。如果遇到此问题，请更新到最新版本或手动在配置中移除\u002F注释掉 `shutdown_delay` 设置。","https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcphub.nvim\u002Fissues\u002F20",{"id":144,"question_zh":145,"answer_zh":146,"source_url":132},25695,"如何配置 MCPHub 以便与 CodeCompanion 集成并使用其工具功能？","在 `setup` 配置中启用 `extensions.codecompanion` 选项。示例配置如下：\n\n```lua\nrequire(\"mcphub\").setup({\n  port = 3000,\n  config = vim.fn.expand(\"~\u002Fmcpservers.json\"),\n  extensions = {\n    codecompanion = {\n      show_result_in_chat = true,\n      make_vars = true, -- 从 MCP 服务器资源创建聊天变量\n      make_slash_commands = true, -- 从 MCP 服务器提示创建斜杠命令\n    },\n  },\n})\n```\n\n注意：除非将 MCPHub 设置为随命令加载（如 `cmd = \"MCPHub\"`），否则它可能直到 CodeCompanion 被激活时才会加载。",{"id":148,"question_zh":149,"answer_zh":150,"source_url":132},25696,"MCPHub 的日志文件应该如何配置？","可以在 `setup` 函数的 `log` 表中配置日志级别、是否写入文件以及文件路径。示例配置：\n\n```lua\nlog = {\n  level = vim.log.levels.WARN, -- 日志级别\n  to_file = true,              -- 是否写入文件\n  file_path = vim.fn.expand(\"~\u002F.config\u002Fnvim\u002Fmcpservers.txt\"), -- 日志文件路径\n  prefix = \"MCPHub\",           -- 日志前缀\n},\n```\n\n这将把警告及以上级别的日志保存到指定文件中，方便调试。",[152,157,162,167,172,177,182,187,192,197,202,207,212,217,222,227,232,237,242,247],{"id":153,"version":154,"summary_zh":155,"released_at":156},162996,"v6.2.0","## 新增\n\n- **CopilotChat 集成**: 完全支持 CopilotChat.nvim 插件\n  - 工具、资源及资源模板集成\n  - 支持函数调用，并实现自动转换\n  - 可选为工具和资源添加 MCP 前缀\n\n## 修复\n\n- 修复了工作区处理中 nil 端口比较的问题\n- 修复了 CopilotChat 插件中缺失资源模板分组的问题\n\n## 变更\n\n- 优化了 Avante 加载逻辑的组织结构\n- 改进了工作区配置的相关文档","2025-07-31T07:53:33",{"id":158,"version":159,"summary_zh":160,"released_at":161},162997,"v6.0.0","### 新增功能\n\n- **工作区感知的 MCP Hub**：支持项目本地配置 (#148, #183, #196, #200)\n  - **智能项目检测**：通过 `.mcphub\u002Fservers.json`、`.vscode\u002Fmcp.json`、`.cursor\u002Fmcp.json` 自动检测项目边界\n  - **隔离的 Hub 实例**：每个工作区拥有独立的 mcp-hub 进程，并分配唯一的端口范围（40000–41000）\n  - **配置合并**：项目配置会自动覆盖全局设置，同时保留全局服务器配置\n  - **自动切换**：在目录变化时（`DirChanged` 事件）无缝切换到对应工作区的 Hub\n  - **动态端口分配**：基于哈希生成端口，具备冲突解决机制，并支持自定义端口分配\n\n- **全局环境变量**：为所有 MCP 服务器注入通用环境变量 (#183)\n  - **灵活配置**：支持表格和函数两种形式的 `global_env` 配置\n  - **上下文感知变量**：函数可接收工作区上下文信息（端口、配置文件、工作区模式等）\n  - **混合格式支持**：既支持数组风格（`\"VAR\"`），也支持哈希风格（`KEY = \"value\"`）的条目\n  - **自动解析**：Hub 启动时会结合项目上下文解析环境变量\n\n- **🎨 界面体验增强**：完整的工作区管理界面\n  - **活跃 Hub 区域**：查看并管理所有正在运行的工作区 Hub 实例\n  - **分组显示服务器**：按配置来源（全局 vs 项目）对服务器进行分组，并提供可视化标识\n  - **多配置编辑器**：基于标签页的界面，用于编辑不同配置文件（全局与项目）\n  - **工作区操作**：展开\u002F折叠详细信息、终止进程、更改目录、查看配置文件\n\n### 优化功能\n\n- **目录变更处理**：在 Neovim 中切换目录时正确切换 Hub\n- **配置文件监听**：增强文件监听功能，以支持多种配置源\n\n一些常用的键位映射，如 `\u003CCr>`、`o` 和 `\u003CEsc>`，现在可以与 `l` 和 `k` 键一起使用。\n\n### 修复内容\n\n- **多项目隔离**：解决了 MCP 服务器在错误项目目录中运行的根本问题\n- **环境变量访问**：修复了用户会话变量（如 `DBUS_SESSION_BUS_ADDRESS`）无法被 MCP 服务器访问的问题\n\n### 迁移指南\n\n现有配置无需更改即可继续使用。若需启用工作区相关功能，请进行如下配置：\n\n```lua\nrequire(\"mcphub\").setup({\n  workspace = {\n    enabled = true, -- 默认值：true\n    look_for = { \".mcphub\u002Fservers.json\", \".vscode\u002Fmcp.json\", \".cursor\u002Fmcp.json\" },\n    reload_on_dir_changed = true,\n    port_range = { min = 40000, max = 41000 },\n    get_port = nil, -- 可选的自定义端口分配函数\n  },\n  global_env = {\n    \"DBUS_SESSION_BUS_ADDRESS\", -- 数组风格：使用 os.getenv()\n    API_KEY = os.getenv(\"API_KEY\"), -- 哈希风格：显式指定值\n  }\n})\n```","2025-07-18T11:42:08",{"id":163,"version":164,"summary_zh":165,"released_at":166},162998,"v5.13.0","### 新增功能\n\n- **CodeCompanion 细粒度工具访问权限**：单个 MCP 服务器和工具现可作为独立的 CodeCompanion 功能工具使用\n  - 支持服务器组（例如 `@github`、`@neovim`）及单个工具（例如 `@github__create_issue`）\n  - 可通过 Hub UI 对每个工具进行自动批准控制\n  - 支持通过 CodeCompanion 组自定义工具组合\n  - 消除系统提示污染，提升模型性能\n\n- **高级 `edit_file` 工具**：交互式 SEARCH\u002FREPLACE 块系统，支持实时差异预览\n  - 智能模糊匹配与全面反馈，助力 LLM 学习\n  - 可通过 `builtin_tools.edit_file` 配置项自定义快捷键和行为\n  - 拥有包含 3000 多个测试用例的完整测试套件\n\n### 优化功能\n\n- **JSON 格式化**：新增 `jq` 支持，用于更美观的配置文件格式化\n- **MCP 工具提示**：改进了 Markdown 格式与结构，以更好地适配 LLM 的理解需求\n\n### 修复问题\n\n- **Avante 集成**：修复了工具输入格式，使 Gemini 模型能够兼容 `use_ReAct_prompt` 设置\n\n","2025-07-14T08:59:30",{"id":168,"version":169,"summary_zh":170,"released_at":171},162999,"v5.12.0","### 增强功能\n- **MCP 注册中心迁移**：已更新以支持 mcp-hub v4.0.0 及其全新的 MCP 注册中心系统\n  - 通过去中心化的注册中心系统提升了可靠性（https:\u002F\u002Fgithub.com\u002Fravitemer\u002Fmcp-registry）\n  - 丰富了服务器元数据，增加了详尽的安装说明\n  - 改进了缓存机制，针对频繁更新的数据设置了 1 小时的 TTL\n\n### 变更\n- 更新 mcp-hub 依赖至 v4.0.0，以适配新的注册中心系统\n- 市场现已使用 MCP 注册中心，而非 Cline 市场 API\n- 增强了市场操作的错误处理机制\n\n","2025-07-09T05:02:05",{"id":173,"version":174,"summary_zh":175,"released_at":176},163000,"v5.11.1","### 新增\n\n- **为 stdio 服务器添加 `cwd` 字段支持**：\n  - 在 `MCPServerConfig` 类型定义中新增 `cwd` 字段\n  - 为服务器配置中的 `cwd` 字段添加验证逻辑\n  - 更新文档，补充示例和使用场景说明\n\n","2025-07-08T05:03:34",{"id":178,"version":179,"summary_zh":180,"released_at":181},163001,"v5.11.0","### 新增\n\n- **支持 XDG 基本目录规范**：已将硬编码的 `~\u002F.mcp-hub` 路径迁移到符合 XDG 规范的目录\n  - 市场缓存现使用 XDG 数据目录 (`~\u002F.local\u002Fshare\u002Fmcp-hub\u002Fcache`)\n  - 日志现使用 XDG 状态目录 (`~\u002F.local\u002Fstate\u002Fmcp-hub\u002Flogs`)\n  - OAuth 存储现使用 XDG 数据目录 (`~\u002F.local\u002Fshare\u002Fmcp-hub\u002Foauth`)\n  - 保持对现有 `~\u002F.mcp-hub` 安装的向后兼容性\n  - 新增 XDG 路径工具模块，内置自动回退逻辑\n\n### 优化\n\n- 更新文档以反映新的符合 XDG 规范的路径结构\n- 按照 Linux 文件系统标准改进了文件组织结构\n\n","2025-06-26T08:59:09",{"id":183,"version":184,"summary_zh":185,"released_at":186},163002,"v5.10.0","### 新增\n\n- 集成了对 MCP Hub 统一端点功能的支持\n  - 添加了双接口方案（管理接口 + MCP 端点）的文档\n  - 添加了统一端点使用场景的配置示例\n\n","2025-06-24T17:04:55",{"id":188,"version":189,"summary_zh":190,"released_at":191},163003,"v5.9.0","### 新增\n\n- 改进了远程\u002F无头服务器的 OAuth 流程\n  - 新的授权弹出窗口界面，配有清晰的操作指引\n  - 为无头环境支持手动回调 URL\n  - 授权成功后自动关闭弹出窗口\n  - 更完善的错误处理和验证机制\n  - 支持在信息窗口和输入窗口之间切换标签页\n\n### 变更\n\n- 更新 mcp-hub 依赖至 v3.5.0，以提升 OAuth 支持能力\n\n","2025-06-24T07:18:59",{"id":193,"version":194,"summary_zh":195,"released_at":196},163004,"v5.8.0","### 新增\n\n- 基于函数的 MCP 工具调用自动审批系统 (#173)\n  - `auto_approve` 现在可以是一个接收工具调用参数的函数\n  - 该函数接收 `server_name`、`tool_name`、`arguments`、`action`、`uri` 和 `is_auto_approved_in_server` 参数\n  - 返回 `true` 表示批准，`false` 表示提示用户确认，或返回字符串以自定义错误消息拒绝\n  - 支持基于工具参数和上下文的复杂审批逻辑\n  - 向后兼容现有的布尔值及服务器级配置\n\n### 变更\n\n- **破坏性变更**：移除了 CodeCompanion 集成中自动检查 `vim.g.codecompanion_auto_tool_mode` 的逻辑\n  - 用户可以通过在自定义 `auto_approve` 函数中检查该变量来实现相同的行为\n  - 简化了自动审批逻辑，并去除了插件特有的依赖\n- 重构了扩展系统，提升模块化程度和类型安全性\n- 更新了自动审批优先级：函数式 → 服务器配置 → 用户提示\n- 优化了 Hub 的启动逻辑，改进了状态管理和重启处理\n\n### 文档\n\n- 添加了全面的基于函数的自动审批示例及参数说明文档\n- 更新了 Avante 和 CodeCompanion 的集成指南，加入了新的自动审批模式\n- 增加了 GitHub 访问控制和项目范围操作的实际应用示例\n\n","2025-06-22T19:09:32",{"id":198,"version":199,"summary_zh":200,"released_at":201},163005,"v5.7.5","### 修复\n\n- 修复了环境变量中嵌套占位符解析不正确的问题 (#170)\n\n### 变更\n\n- 将 mcp-hub 依赖更新至 v3.4.5，以改进嵌套占位符的解析功能\n\n\n","2025-06-18T06:20:12",{"id":203,"version":204,"summary_zh":205,"released_at":206},163006,"v5.7.4","### Added\n- Added vim.g.mcphub configuration support for package manager friendly configuration (#167)\n- Auto-setup logic for vim.g.mcphub in plugin\u002Fmcphub.lua\n- Comprehensive welcome screen for not_started state with configuration examples\n- Support for both vim.g.mcphub and traditional setup() approaches\n- Package manager friendly configuration (NixOS, rocks.nvim)\n- Added devShell with pandoc and stylua for development (#165)\n\n### Changed\n- Moved MCPHub command creation to plugin file with on-demand UI creation\n- Decoupled command creation from setup() function for better initialization\n- Maintain full backward compatibility with existing setup approaches\n\n### Fixed\n- Show better error messages with config errors (#163)\n- Fire tool call result on MCPHubToolEnd events\n\n","2025-06-16T16:16:24",{"id":208,"version":209,"summary_zh":210,"released_at":211},163007,"v5.7.3","### Changed\n- Added proper plugin initialization with highlight setup\n- Refactored highlights to use theme-linked groups instead of custom colors (#158)\n- configurable builtin replace_in_file tool keymaps (#159)\n\n### Fixed\n- Fixed env resolution strict mode preventing server startups\n\n","2025-06-13T09:26:17",{"id":213,"version":214,"summary_zh":215,"released_at":216},163008,"v5.7.2","### Fixed\n- Fixed `${cmd: ...}` placeholders not working in remote server configs without an `env` field\n- Commands can now be executed in any config field (url, headers, args, command), not just env\n- Better handling of circular dependencies in environment variable resolution\n\n","2025-06-11T06:07:30",{"id":218,"version":219,"summary_zh":220,"released_at":221},163009,"v5.7.1","### Changed\n- Server configuration now supports `${ENV_VAR}` and `${cmd: command args}` syntax in all fields\n- Updated mcp-hub dependency to v3.4.0 for universal `${}` placeholder syntax support\n- Updated documentation to reflect new universal placeholder syntax features\n- Better log avante tool calls \n\n","2025-06-10T18:43:41",{"id":223,"version":224,"summary_zh":225,"released_at":226},163010,"v5.7.0","### Added\n- Use `name` field from MCP server config in the UI (#152)\n\n### Fixed\n- Bug when server has only resource templates (#147)\n- Validate MCP server config fields (#149)\n- Show error message on setup failed\n- Error concatenation in checkhealth (#153)\n- Fallback to curl to fetch marketplace data\n\n### Changed\n- Use pname in nix-flake (#146)\n- Updated sponsors in README\n\n","2025-06-05T17:08:04",{"id":228,"version":229,"summary_zh":230,"released_at":231},163011,"v5.6.1","## Fixed\n- Tool list changed event not updating in the UI\n\n### Changed\n- Updated mcp-hub dependency to v3.3.1 for improved subscription event handling\n\n","2025-05-30T07:16:56",{"id":233,"version":234,"summary_zh":235,"released_at":236},163012,"v5.6.0","### Added\n- Fine-grained auto-approval support for servers and tools\n- `autoApprove` field in server config (boolean or string array)\n- `a` keymap to toggle auto-approval on servers and individual tools\n- Visual indicators for auto-approval status in UI\n- Support for editing native server config fields from UI\n\n### Changed\n- Resources are now always auto-approved by default\n- Enhanced confirmation prompt UI\n\n### Fixed\n- Nix flake now includes plenary dependency\n\n","2025-05-28T06:24:21",{"id":238,"version":239,"summary_zh":240,"released_at":241},163013,"v5.5.0","### Added\n- Dev mode for automatic MCP server restart on file changes during development\n- New `dev` configuration field with `enabled`, `watch`, and `cwd` options\n- File watching with glob pattern support for universal project compatibility  \n\n","2025-05-26T11:18:33",{"id":243,"version":244,"summary_zh":245,"released_at":246},163014,"v5.4.0","## What's New\n\n🎨 **Beautiful Tool Confirmation Dialog**\n- Completely redesigned confirmation UI with floating window\n- Syntax highlighting for parameters\n- Support for multiline strings and complex data types\n- Fixed screen flashing and missing information issues (#131)\n\n## Screenshots\n\n![New Confirmation Dialog](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F201a5804-99b6-4284-9351-348899e62467)\n\nNo more flashing screens or missing tool information - you now get a beautiful, informative confirmation dialog for all MCP tool calls!","2025-05-24T11:39:06",{"id":248,"version":249,"summary_zh":250,"released_at":251},163015,"v5.3.1","### Added\n- For long running tools or prompts or resources, we can now set `mcp_request_timeout` in ms to wait for the execution to finish. Defaults to 60s.\n\n### Changed\n- Updated mcp-hub dependency version\n\n","2025-05-24T07:11:05"]