[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-vercel--mcp-handler":3,"tool-vercel--mcp-handler":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 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[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},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"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":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":75,"owner_company":76,"owner_location":76,"owner_email":77,"owner_twitter":76,"owner_website":78,"owner_url":79,"languages":80,"stars":89,"forks":90,"last_commit_at":91,"license":76,"difficulty_score":32,"env_os":92,"env_gpu":93,"env_ram":92,"env_deps":94,"category_tags":103,"github_topics":76,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":104,"updated_at":105,"faqs":106,"releases":136},6340,"vercel\u002Fmcp-handler","mcp-handler","Easily spin up an MCP Server on Next.js, Nuxt, Svelte, and more","mcp-handler 是一款专为现代前端框架设计的适配器，旨在帮助开发者轻松构建基于模型上下文协议（MCP）的服务器。它主要解决了在 Next.js、Nuxt 等流行框架中集成 AI 实时通信能力的难题，让应用程序能够顺畅地与 AI 模型进行工具调用和数据交互，而无需从零搭建复杂的底层架构。\n\n这款工具非常适合熟悉 JavaScript 或 TypeScript 的前端及全栈开发者使用。如果你希望在现有的 Web 项目中快速引入 AI 功能，例如让 AI 助手执行自定义操作（如查询数据库、调用外部 API 或处理业务逻辑），mcp-handler 能提供极大的便利。\n\n其技术亮点在于对多种传输协议的灵活支持，不仅兼容高效的 Streamable HTTP，还支持带有断点续传功能的服务器发送事件（SSE），并可结合 Redis 提升稳定性。此外，它内置了完整的 TypeScript 类型定义，确保开发过程中的代码智能提示与类型安全。通过简单的配置，开发者即可在几分钟内将普通的 API 路由转化为功能强大的 MCP 服务端点，大幅降低了 AI 应用集成的门槛。","# mcp-handler\n\nA Vercel adapter for the Model Context Protocol (MCP), enabling real-time communication between your applications and AI models. Supports Next.js and Nuxt.\n\n## Installation\n\n```bash\nnpm install mcp-handler @modelcontextprotocol\u002Fsdk@1.26.0 zod@^3\n```\n\n> **Note**: Versions of `@modelcontextprotocol\u002Fsdk` prior to 1.26.0 have a security vulnerability. Use version 1.26.0 or later.\n\n## Quick Start (Next.js)\n\n```typescript\n\u002F\u002F app\u002Fapi\u002F[transport]\u002Froute.ts\nimport { createMcpHandler } from \"mcp-handler\";\nimport { z } from \"zod\";\n\nconst handler = createMcpHandler(\n  (server) => {\n    server.registerTool(\n      \"roll_dice\",\n      {\n        title: \"Roll Dice\",\n        description: \"Roll a dice with a specified number of sides.\",\n        inputSchema: {\n          sides: z.number().int().min(2),\n        },\n      },\n      async ({ sides }) => {\n        const value = 1 + Math.floor(Math.random() * sides);\n        return {\n          content: [{ type: \"text\", text: `🎲 You rolled a ${value}!` }],\n        };\n      }\n    );\n  },\n  {},\n  {\n    basePath: \"\u002Fapi\", \u002F\u002F must match where [transport] is located\n    maxDuration: 60,\n    verboseLogs: true,\n  }\n);\n\nexport { handler as GET, handler as POST };\n```\n\n## Connecting Clients\n\nIf your client supports Streamable HTTP, connect directly:\n\n```json\n{\n  \"remote-example\": {\n    \"url\": \"http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fmcp\"\n  }\n}\n```\n\nFor stdio-only clients, use [mcp-remote](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmcp-remote):\n\n```json\n{\n  \"remote-example\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"mcp-remote\", \"http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fmcp\"]\n  }\n}\n```\n\n## Documentation\n\n- [Client Integration](docs\u002FCLIENTS.md) - Claude Desktop, Cursor, Windsurf setup\n- [Authorization](docs\u002FAUTHORIZATION.md) - OAuth and token verification\n- [Advanced Usage](docs\u002FADVANCED.md) - Dynamic routing, Nuxt, configuration options\n\n## Features\n\n- **Framework Support**: Next.js and Nuxt\n- **Multiple Transports**: Streamable HTTP and Server-Sent Events (SSE)\n- **Redis Integration**: Optional, for SSE transport resumability\n- **TypeScript Support**: Full type definitions included\n\n## Requirements\n\n- Next.js 13+ or Nuxt 3+\n- Node.js 18+\n- Redis (optional, for SSE)\n\n## License\n\nApache-2.0\n","# mcp-handler\n\n用于模型上下文协议 (MCP) 的 Vercel 适配器，可在您的应用程序与 AI 模型之间实现实时通信。支持 Next.js 和 Nuxt。\n\n## 安装\n\n```bash\nnpm install mcp-handler @modelcontextprotocol\u002Fsdk@1.26.0 zod@^3\n```\n\n> **注意**：`@modelcontextprotocol\u002Fsdk` 版本低于 1.26.0 存在安全漏洞。请使用 1.26.0 或更高版本。\n\n## 快速入门（Next.js）\n\n```typescript\n\u002F\u002F app\u002Fapi\u002F[transport]\u002Froute.ts\nimport { createMcpHandler } from \"mcp-handler\";\nimport { z } from \"zod\";\n\nconst handler = createMcpHandler(\n  (server) => {\n    server.registerTool(\n      \"roll_dice\",\n      {\n        title: \"掷骰子\",\n        description: \"掷一个指定面数的骰子。\",\n        inputSchema: {\n          sides: z.number().int().min(2),\n        },\n      },\n      async ({ sides }) => {\n        const value = 1 + Math.floor(Math.random() * sides);\n        return {\n          content: [{ type: \"text\", text: `🎲 你掷出了 ${value}！` }],\n        };\n      }\n    );\n  },\n  {},\n  {\n    basePath: \"\u002Fapi\", \u002F\u002F 必须与 [transport] 所在路径一致\n    maxDuration: 60,\n    verboseLogs: true,\n  }\n);\n\nexport { handler as GET, handler as POST };\n```\n\n## 连接客户端\n\n如果您的客户端支持可流式传输的 HTTP，请直接连接：\n\n```json\n{\n  \"remote-example\": {\n    \"url\": \"http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fmcp\"\n  }\n}\n```\n\n对于仅支持标准输入输出的客户端，请使用 [mcp-remote](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmcp-remote)：\n\n```json\n{\n  \"remote-example\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"mcp-remote\", \"http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fmcp\"]\n  }\n}\n```\n\n## 文档\n\n- [客户端集成](docs\u002FCLIENTS.md) - Claude Desktop、Cursor、Windsurf 的设置\n- [授权](docs\u002FAUTHORIZATION.md) - OAuth 和令牌验证\n- [高级用法](docs\u002FADVANCED.md) - 动态路由、Nuxt、配置选项\n\n## 特性\n\n- **框架支持**：Next.js 和 Nuxt\n- **多种传输方式**：可流式传输的 HTTP 和服务器发送事件 (SSE)\n- **Redis 集成**：可选，用于 SSE 传输的断点续传\n- **TypeScript 支持**：包含完整的类型定义\n\n## 要求\n\n- Next.js 13+ 或 Nuxt 3+\n- Node.js 18+\n- Redis（可选，用于 SSE）\n\n## 许可证\n\nApache-2.0","# mcp-handler 快速上手指南\n\n`mcp-handler` 是一个专为 Vercel 平台设计的 Model Context Protocol (MCP) 适配器，支持 Next.js 和 Nuxt 框架，可实现应用程序与 AI 模型之间的实时通信。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **运行时**: Node.js 18 或更高版本\n*   **框架**: Next.js 13+ 或 Nuxt 3+\n*   **可选依赖**: Redis（仅在使用 SSE 传输且需要恢复连接时需要）\n\n## 安装步骤\n\n使用 npm 安装核心库及必要的依赖项。请注意，`@modelcontextprotocol\u002Fsdk` 必须使用 **1.26.0** 或更高版本以修复安全漏洞。\n\n```bash\nnpm install mcp-handler @modelcontextprotocol\u002Fsdk@1.26.0 zod@^3\n```\n\n> **提示**：国内开发者若遇到下载缓慢问题，可配置淘宝镜像源：\n> `npm config set registry https:\u002F\u002Fregistry.npmmirror.com`\n\n## 基本使用 (Next.js)\n\n以下示例展示如何在 Next.js App Router 中创建一个简单的 MCP 服务端点，注册一个“掷骰子”工具。\n\n1.  在项目中的 `app\u002Fapi\u002F[transport]\u002Froute.ts` 路径下创建文件（`[transport]` 为动态路由段）。\n2.  填入以下代码：\n\n```typescript\n\u002F\u002F app\u002Fapi\u002F[transport]\u002Froute.ts\nimport { createMcpHandler } from \"mcp-handler\";\nimport { z } from \"zod\";\n\nconst handler = createMcpHandler(\n  (server) => {\n    server.registerTool(\n      \"roll_dice\",\n      {\n        title: \"Roll Dice\",\n        description: \"Roll a dice with a specified number of sides.\",\n        inputSchema: {\n          sides: z.number().int().min(2),\n        },\n      },\n      async ({ sides }) => {\n        const value = 1 + Math.floor(Math.random() * sides);\n        return {\n          content: [{ type: \"text\", text: `🎲 You rolled a ${value}!` }],\n        };\n      }\n    );\n  },\n  {},\n  {\n    basePath: \"\u002Fapi\", \u002F\u002F 必须与 [transport] 所在的路径前缀匹配\n    maxDuration: 60,\n    verboseLogs: true,\n  }\n);\n\nexport { handler as GET, handler as POST };\n```\n\n3.  启动开发服务器，您的 MCP 服务即可在 `http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fmcp` (或其他 transport 名称) 访问。\n\n**客户端连接示例**：\n若您的客户端支持 Streamable HTTP，可直接配置 URL：\n```json\n{\n  \"remote-example\": {\n    \"url\": \"http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fmcp\"\n  }\n}\n```","某电商团队希望在 Next.js 构建的后台系统中，让 AI 助手能实时调用内部库存查询和订单修改功能，以辅助客服快速响应。\n\n### 没有 mcp-handler 时\n- **开发成本高**：需手动搭建独立的 MCP 服务器进程，处理复杂的 HTTP 轮询或 WebSocket 连接，与主应用分离部署。\n- **上下文割裂**：AI 模型无法直接访问 Next.js 应用内的数据库连接或认证上下文，需额外编写中间层透传数据。\n- **维护困难**：缺乏标准化的工具注册机制，每次新增功能（如“退款”或“查物流”）都要修改底层通信协议代码。\n- **调试复杂**：请求链路不透明，难以追踪 AI 调用具体哪个后端函数，错误日志分散在不同服务中。\n\n### 使用 mcp-handler 后\n- **极速集成**：直接在 Next.js 的 API 路由中通过 `createMcpHandler` 注册工具，无需独立部署服务器，复用现有项目结构。\n- **原生上下文访问**：工具函数可直接读取 Next.js 环境变量、数据库客户端及用户 Session，实现安全的内部操作。\n- **标准化扩展**：只需定义 Zod 校验 schema 和异步处理函数即可新增\"roll_dice\"类工具，框架自动处理协议转换。\n- **可观测性增强**：内置详细日志（`verboseLogs`）和统一错误处理，开发者可在同一终端监控所有 AI 交互细节。\n\nmcp-handler 将原本繁琐的跨进程通信简化为标准的 API 路由开发，让前端团队能像编写普通接口一样轻松赋予 AI 操作真实业务的能力。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvercel_mcp-handler_818b4de5.png","vercel","Vercel","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fvercel_d9ebfb29.png","Develop. Preview. Ship. Creators of Next.js.",null,"contactus@vercel.com","https:\u002F\u002Fvercel.com","https:\u002F\u002Fgithub.com\u002Fvercel",[81,85],{"name":82,"color":83,"percentage":84},"TypeScript","#3178c6",95.1,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",4.9,579,78,"2026-04-10T07:40:35","未说明","无 GPU 需求",{"notes":95,"python":96,"dependencies":97},"该工具是基于 JavaScript\u002FTypeScript 的 Vercel 适配器，用于 Model Context Protocol (MCP)，不支持 Python 环境。Redis 为可选依赖，仅在使用 SSE 传输模式时需要。注意 @modelcontextprotocol\u002Fsdk 版本必须为 1.26.0 或更高以修复安全漏洞。","不适用 (基于 Node.js)",[98,99,100,101,102],"@modelcontextprotocol\u002Fsdk@1.26.0","zod@^3","Next.js 13+","Nuxt 3+","Node.js 18+",[14,52],"2026-03-27T02:49:30.150509","2026-04-11T03:22:47.512149",[107,112,117,122,127,132],{"id":108,"question_zh":109,"answer_zh":110,"source_url":111},28709,"部署后出现内存泄漏（McpServer 实例未清理）怎么办？","这是一个已知问题，已在 `mcp-handler@1.0.2` 版本中修复。请升级依赖包到该版本或更高版本：\n`npm install mcp-handler@^1.0.2`\n升级后，连接实例将被正确清理，内存泄漏问题将完全解决。","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fmcp-handler\u002Fissues\u002F94",{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},28710,"升级到 0.8.1\u002F0.8.2 后报错 'Cannot find module ... auth\u002Ferrors' 如何解决？","这是依赖项路径解析的问题。请将 `@vercel\u002Fmcp-adapter` 升级到 `0.10.0` 或更高版本，维护者已在此版本中修复了该错误并精简了依赖：\n`npm install @vercel\u002Fmcp-adapter@^0.10.0`\n如果问题仍然存在，请尝试清理 node_modules 并重新安装依赖。","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fmcp-handler\u002Fissues\u002F47",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},28711,"使用 Zod v4 时，tool\u002Flist 返回的 inputSchema 属性为空（{}）怎么办？","这是因为底层 SDK 需要更新以支持 Zod v4 的转换逻辑。请确保以下依赖版本满足要求：\n1. `@modelcontextprotocol\u002Fsdk` 升级到 `1.23.0` 或更高。\n2. `mcp-handler` 升级到 `1.0.4` 或更高。\n3. 保持 `zod` 为 v4 版本（如 `4.1.9`）。\n更新后，Zod schema 将能正确转换为 JSON Schema 并显示在 tool\u002Flist 响应中。","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fmcp-handler\u002Fissues\u002F107",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},28712,"如何在初始化服务器时处理异步操作（避免 'Cannot register capabilities after connecting' 错误）？","如果在注册 tool 或 resource 时需要执行异步操作，可能会导致在连接传输后尝试注册能力的错误。推荐的解决方案是使用 `mcp-remote` 来桥接客户端和服务端，它支持 StreamableHTTP 传输协议，可以更灵活地处理初始化和异步加载过程。这允许后端使用 StreamableHTTP，同时让现有的 Stdio 客户端（如 Claude、Cursor）正常消费服务。","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fmcp-handler\u002Fissues\u002F17",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},28713,"在 Next.js 动态路由（如 [serverName]\u002F[transport]）中使用 MCP Handler 报 404 错误怎么办？","动态路由参数可能导致路由匹配失败。建议检查路由文件结构是否符合 Next.js App Router 规范，并确保 `createMcpHandler` 正确导出了 GET 和 POST 方法。如果问题持续，可能需要重构代码以静态方式处理服务器名称，或者在中间件中手动解析动态参数并传递给 handler。维护者建议如有必要可提交包含最小复现代码的新 Issue 以便进一步排查。","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fmcp-handler\u002Fissues\u002F28",{"id":133,"question_zh":134,"answer_zh":135,"source_url":126},28714,"如何让不支持 StreamableHTTP 的旧客户端（如 Cursor\u002FClaude）连接到使用新协议的 MCP 服务器？","最佳方案是使用 `mcp-remote` 工具作为代理。配置后端服务器使用 StreamableHTTP（而非 SSE），然后让用户通过 `mcp-remote` 连接。`mcp-remote` 会将请求转换为 Stdio 协议，从而使现有的桌面客户端（如 Claude Desktop, Cursor, Windsurf）能够无缝连接到你的远程 MCP 服务器。参考示例项目：https:\u002F\u002Fmcp.solana.com\u002F",[137,142,147,152,157,162,167,172,177,182,187,192,197,202,207,212,217,222,227,232],{"id":138,"version":139,"summary_zh":140,"released_at":141},197614,"v1.1.0","### 小改动\n\n-   7ac97dc：要求最低版本为 @modelcontextprotocol\u002Fsdk@1.26.0，该版本使用 Web Streams\n","2026-03-24T00:13:04",{"id":143,"version":144,"summary_zh":145,"released_at":146},197615,"v1.0.7","### 补丁变更\n\n-   5a92040：为修复漏洞，将 MCP TS SDK 的固定版本更新至 1.25.2\n-   8c51d39：允许传入 sessionIdGenerator 以支持有状态会话\n","2026-01-09T21:58:31",{"id":148,"version":149,"summary_zh":150,"released_at":151},197616,"v1.0.6","### 补丁变更\n\n-   a9c7af5：确保认证配置文件始终与请求绑定\n","2026-01-05T20:57:42",{"id":153,"version":154,"summary_zh":155,"released_at":156},197617,"v1.0.5","### 补丁变更\n\n-   81bdf1c：更新 README、示例，并支持 MCP TS SDK 1.25.0 及更高版本\n-   6e75141：向传入消息添加原始头信息\n-   51b8a24：升级 @modelcontextprotocol\u002Fsdk 版本\n","2026-01-03T21:17:34",{"id":158,"version":159,"summary_zh":160,"released_at":161},197618,"v1.0.4","### 补丁变更\n\n- 1.0.4：更新依赖项，使用 @modelcontextprotocol\u002Fsdk 的 1.22.0 版本\n","2025-11-20T03:23:05",{"id":163,"version":164,"summary_zh":165,"released_at":166},197619,"v1.0.3","### 补丁变更\n\n-   639e634：更新 OAuth 使用方式\n","2025-10-10T22:24:54",{"id":168,"version":169,"summary_zh":170,"released_at":171},197620,"v1.0.2","### 补丁变更\n\n-   956dc11：修复使用 SSE 连接时的内存泄漏问题\n","2025-08-25T19:33:54",{"id":173,"version":174,"summary_zh":175,"released_at":176},197621,"v1.0.1","### 补丁变更\n\n-   d829aa6：PRM 资源标识符计算考虑路径\n","2025-07-19T21:56:21",{"id":178,"version":179,"summary_zh":180,"released_at":181},197622,"v1.0.0","### 主要变更\n\n-   201a1c7：将包从 @vercle\u002Fmcp-adapter 移至 mcp-handler\n\n### 次要变更\n\n-   488dfe4：重构打包流程，并使 withMcpAuth 稳定\n-   02df830：添加 RFC 9728 OAuth 保护资源元数据处理器\n","2025-07-11T20:53:13",{"id":183,"version":184,"summary_zh":185,"released_at":186},197623,"v0.11.2","### 补丁变更\n\n-   c5c4ba5: 构建优化：正确解析 ESM 类型\n","2025-07-07T17:19:42",{"id":188,"version":189,"summary_zh":190,"released_at":191},197624,"v0.11.1","### Patch Changes\n\n-   fc2a6d8: Update README during NPM outage\n","2025-06-12T22:53:07",{"id":193,"version":194,"summary_zh":195,"released_at":196},197625,"v0.11.0","### Minor Changes\n\n-   7149159: Support adding serverMetadata to name and version the mcp server\n","2025-06-12T20:20:07",{"id":198,"version":199,"summary_zh":200,"released_at":201},197626,"v0.10.0","### Minor Changes\n\n-   71c14ea: Fix import error with mcp sdk\n\n### Patch Changes\n\n-   71c14ea: Fix module resolution\n","2025-06-09T17:30:20",{"id":203,"version":204,"summary_zh":205,"released_at":206},197627,"v0.9.1","### Patch Changes\n\n-   c86da9a: Not optional\n","2025-06-06T01:07:46",{"id":208,"version":209,"summary_zh":210,"released_at":211},197628,"v0.9.0","### Minor Changes\n\n-   58efcf0: Add peerDependenciesMeta to fix not packaging the MCP SDK anymore\n","2025-06-06T01:00:56",{"id":213,"version":214,"summary_zh":215,"released_at":216},197629,"v0.8.2","### Patch Changes\n\n-   15fded0: Fix mjs module resolution\n","2025-06-04T22:03:41",{"id":218,"version":219,"summary_zh":220,"released_at":221},197630,"v0.8.1","### Patch Changes\n\n-   83e6fc7: Move zod to DevDep\n-   12b61fd: Add more robust error handling to auth logic\n-   a522ffd: Move zod to devDep\n","2025-06-04T19:51:59",{"id":223,"version":224,"summary_zh":225,"released_at":226},197631,"v0.8.0","### Minor Changes\n\n-   166e5ab: Add option to disable SSE as per MCP spec\n\n### Patch Changes\n\n-   62518f2: Fix timeout scoping bug causing ReferenceError in SSE Handler\n-   c55c609: Update auth logic to not throw error is missing bearerToken\n","2025-06-04T18:31:29",{"id":228,"version":229,"summary_zh":230,"released_at":231},197632,"v0.7.3","### Patch Changes\n\n-   8fd2538: Fix missing non async argument\n","2025-05-29T11:47:21",{"id":233,"version":234,"summary_zh":235,"released_at":236},197633,"v0.7.2","### Patch Changes\n\n-   47eff5a: Fix allowing both async and non async handlers\n","2025-05-29T11:41:29"]