用途:在 Netlify 上构建自己的远程 MCP 服务器,即一个通过 HTTP 讲 MCP 协议的 Netlify Function,把应用的工具与数据暴露给 AI 客户端。注意区分:Netlify 官方托管的 MCP 服务器用于让 AI 操作 Netlify 平台本身,本技能是自建服务器。
主要能力:使用官方 MCP SDK 的 Web 标准 Streamable HTTP 传输,在 Netlify Function 中无状态运行;定义工具(名称、描述、zod 输入 schema、处理器);支持单共享密钥或基于 Netlify Identity 的按用户 API 密钥认证;支持 CORS、速率限制、预签名 URL 文件上传到 Netlify Blobs;提供连接客户端与本地开发部署指引。
使用方式:安装依赖 npm install @modelcontextprotocol/sdk zod;在 netlify/functions/mcp.ts 中创建服务器与传输,设置 config 的 path 为 /mcp;用 netlify dev 本地运行,用 MCP Inspector 测试,用 netlify deploy --build --prod 部署;密钥通过 netlify env:set 设为环境变量。客户端可用 claude mcp add --transport http 或 npx mcp-remote 连接。
限制:函数无状态,模块级内存不跨请求或实例持久,需用 Netlify Blobs 或数据库保存状态;浏览器客户端需自行处理 CORS 预检;Netlify Identity 在 netlify dev 下不可用,按用户密钥需在部署预览测试;不得硬编码密钥,否则会触发密钥扫描导致部署失败。