graft
一次定义，同时生成HTTP和MCP接口的API框架
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：graft。 它的用途是：一次定义，同时生成HTTP和MCP接口的API框架 完整的 Skill 内容见：https://321skill.com/skills/graft/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我查一下用户ID为123的信息。’AI Agent会通过MCP协议调用你使用Graft定义的`lookup_user`工具。同时，前端开发人员也可以直接在浏览器中访问`GET /lookup-user?id=123`这个HTTP端点获取相同的数据。一次定义，满足了AI和传统客户端的双重需求。
介绍
Graft 解决了开发者需要为AI Agent（通过MCP协议）和传统客户端（通过HTTP）分别构建和维护两套API接口的重复劳动问题。它允许开发者用一套代码定义工具（Tool），然后自动生成兼容MCP协议和HTTP协议的接口，实现‘一次定义，双端可用’。
使用方式非常灵活：你可以通过npx @schrepa/create-graft-app快速创建新项目；也可以利用npx @schrepa/graft serve将现有的任何HTTP API（通过OpenAPI规范或配置文件）包装成MCP工具，无需修改后端代码；还可以将Graft中间件集成到现有的Node.js、Bun、Deno或Cloudflare Workers应用中。
它非常适合两类开发者：一是正在构建AI原生应用，希望让AI Agent能通过MCP协议直接调用其服务能力的团队；二是拥有成熟后端服务，希望快速、无侵入地为其增加AI Agent访问能力，而不想重写API的开发者。
与单纯提供MCP服务器SDK或HTTP框架的工具不同，Graft的核心价值在于‘协议桥接’。它不是一个功能更全的Web框架，而是一个专注于消除MCP与HTTP之间鸿沟的粘合层，通过统一的定义和管道，确保两种协议下的认证、验证、中间件逻辑完全一致，极大降低了开发和维护成本。
核心特点
核心区别在于其‘协议桥接’的定位：它不是另一个MCP服务器实现，而是通过单一代码定义，自动、对等地生成MCP和HTTP两套接口，并确保两者在认证、验证等核心管道上完全一致，实现了真正的‘一次编写，双协议暴露’。
注意事项
不适合需要高度定制化、复杂路由或特定Web框架高级功能的单体Web应用开发场景。
常见问题
Graft和普通Web框架（如Express）有什么区别？
Graft不是替代品，而是补充。它专注将API工具同时暴露给MCP Agent和HTTP客户端，自带协议转换和发现文档，可包装现有Express等框架的应用。
用Graft需要重写我的后端API吗？
不需要。Graft支持通过OpenAPI规范或配置文件零代码包装现有API，任何语言和框架的后端都可以被快速赋予MCP能力。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graft/raw/index.md 读取 graft 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graft/raw/index.md（查看排版版本）