用途:在构建 Hono Web 应用或询问 Hono API、路由、中间件、JSX、校验、测试、流式响应时提供内联 API 知识,帮助 AI 编写和调试 Hono 代码。若配置了 hono-docs MCP 服务器,应优先使用其工具获取最新文档。
主要能力:覆盖 App 构造与 TypeScript 泛型 Env;HTTP 方法路由与自定义方法;路径参数、可选参数、通配符、正则约束、链式路由与 route()/basePath() 分组;notFound 与 onError 错误处理;Context 的响应方法(text/json/html/redirect/body/notFound)、状态与响应头设置、c.set()/c.get() 变量;Cloudflare Workers 的 c.env 与 executionCtx;Renderer 与 c.render();HonoRequest 的参数、查询、请求头和 body 解析(json/text/formData/parseBody/arrayBuffer/blob)及 c.req.valid();内置中间件(cors、logger、basicAuth、jwt、csrf、cache、compress 等)与 createMiddleware 自定义中间件及其执行顺序;Zod 与 Standard Schema 校验;JSX 配置、组件、异步组件、Fragments 与 jsxRenderer;stream、streamText、streamSSE 流式响应;app.request() 测试;hc() RPC 类型安全客户端与 InferRequestType/InferResponseType;helpers 与 createFactory;多运行时适配。
使用方式:文档示例通过 npx hono request [file] -P /path 测试端点,POST 示例为 npx hono request [file] -X POST -P /api/users -d '{"name": "test"}';需要 Cloudflare Workers 绑定时改用 npx workers-fetch。JSX 需在 tsconfig.json 设置 "jsx": "react-jsx" 与 "jsxImportSource": "hono/jsx",且文件扩展名为 .tsx。Node.js 下使用 @hono/node-server 的 serve(app)。RPC 客户端要求服务端路由链式书写以保留类型推断。
适用场景与限制:适用于 Hono 应用开发、路由与中间件设计、请求校验、JSX 渲染、流式接口、测试及 RPC 客户端。CLI 参数中不得直接传入凭据,敏感值应使用环境变量;hono request 不支持 Cloudflare Workers 绑定(KV、D1、R2 等),需要绑定时使用 workers-fetch。当前资料未提供该技能的收费、价格与具体平台支持范围,也暂未提供更完整的版本或性能信息。