Slidev 如何把内置 MCP 服务器接入 Claude Code 或 VS Code 让 AI Agent 编辑幻灯片
Slidev 如何把内置 MCP 服务器接入 Claude Code 或 VS Code 让 AI Agent 编辑幻灯片【免费下载链接】slidevPresentation Slides for Developers项目地址: https://gitcode.com/GitHub_Trending/sl/slidevSlidev 内置了一个 MCPModel Context Protocol服务器文档标注since: v52.17.0任何支持 MCP 的 AI Agent——Claude Code、Codex、Cursor、VS Code Copilot 等——都可以用它通过结构化工具来检查、编辑、重排和导航你的幻灯片而不是直接改 Markdown 文本。这篇文档对应 MCP Server 官方文档覆盖两条接入路径开发服务器运行时的 HTTP 端点以及无需开发服务器的 stdio 独立服务器。前提条件来自 Getting Started 与 CLI 文档已安装 Node.js 20.12.0已有一个 Slidev 项目如通过pnpm create slidev/npm init slidevlatest创建CLI 已随项目本地安装或已全局安装slidev/cli并拥有入口文件如slides.mdSlidev 版本需包含内置 MCP 服务器功能v52.17.0 起。路径一主路径通过开发服务器的 HTTP 端点接入开发服务器运行期间MCP 服务器通过 streamable HTTP 传输暴露在http://localhost:port/__mcp其中port替换为你的实际端口。按 CLI 文档slidev开发命令的--port默认值为3030因此未改端口时端点即http://localhost:3030/__mcp。注册到 Claude Code在终端执行claude mcp add --transport http slidev http://localhost:3030/__mcp命令中的slidev是注册给 Agent 的服务名称末尾是开发服务器的 MCP 端点地址。注册到 VS Code / Cursor在 MCP 配置中加入{ mcpServers: { slidev: { type: http, url: http://localhost:3030/__mcp } } }关闭端点可选如果不想暴露这个端点在幻灯片的 headmatter 中设置--- mcp: false ---路径二替代无需开发服务器的 stdio 服务器没有运行开发服务器时可以启动一个独立的 stdio MCP 服务器直接操作 Markdown 文件slidev mcp [entry][entry]为幻灯片入口路径默认slides.md见 CLI 文档。官方 MCP 文档给出的注册示例{ mcpServers: { slidev: { command: npx, args: [slidev, mcp, slides.md] } } }这里需要留意一处文档间的差异CLI 文档提示“通常npx slidev不受支持因为包名实际是slidev/cli”。如果npx slidev无法解析按 CLI 文档的前提安装说明将slidev/cli全局安装npm i -g slidev/cli等或在 Node.js 项目中本地安装后直接使用slidev可执行文件。Agent 接入后能获得哪些工具连接成功后Agent 可以使用以下工具引自 MCP 文档工具说明slidev-get-info演示概览入口文件、标题、幻灯片数量、Markdown 文件、开发服务器 URL 与当前位置slidev-list-slides列出所有幻灯片含编号、标题、布局和源文件slidev-get-slide获取单张幻灯片的完整源码frontmatter、内容、演讲者备注slidev-update-slide更新某张幻灯片的内容、备注和/或 frontmatterslidev-insert-slide在现有幻灯片之后插入新幻灯片slidev-remove-slide删除一张幻灯片slidev-move-slide将幻灯片移到另一张之前/之后重排顺序slidev-goto-slide让实时演示跳转到某张幻灯片仅开发服务器模式可用两个关键行为细节幻灯片按渲染后的 1 起始编号寻址与演示中显示的幻灯片编号一致通过 MCP 工具做的编辑会写回你的 Markdown 文件并即时热更新。验证接入是否生效文档给出了两条可操作的验证依据连接后让 Agent 调用slidev-get-info或slidev-list-slides应返回演示的入口文件、标题、幻灯片数量和编号列表说明端点可达且解析正常让 Agent 执行一次编辑如用slidev-update-slide修改某页内容开发服务器模式下改动写回 Markdown 后浏览器即时热更新还可以用slidev-goto-slide让所有已连接的浏览器跳转到该页——文档特别指出这适合“编辑完立刻在视觉上核对这一页”stdio 模式下没有slidev-goto-slide源码注释也说明 stdio 服务器不提供 live-navigation 工具验证方式为直接查看入口 Markdown 文件中对应幻灯片的内容、备注或 frontmatter 是否已被改写。可选补充VS Code 扩展的 Language Model Tools如果你主要用 VS CodeVS Code 扩展v0.52.0 起另提供一组 Language Model Tools让 Copilot 等 AI 助手不经过 MCP 端点也能操作项目slidev_getActiveSlide获取当前活动幻灯片与项目信息、slidev_getSlideContent按编号取幻灯片内容、slidev_getAllSlideTitles列出全部标题、slidev_findSlideNoByTitle按标题找编号、slidev_listEntries列出所有已加载的入口、slidev_getPreviewPort获取预览服务器端口、slidev_chooseEntry切换活动入口。这组工具偏“读取与导航”要做结构化编辑仍建议走本文的 MCP 路径。另外Work with AI 文档提到可给 Agent 安装官方 skill让它掌握 Slidev 语法与最佳实践后再配合 MCP 使用npx skills add slidevjs/slidev限制slidev-goto-slide只在开发服务器模式下可用stdio 模式直接读写文件无实时导航。端点默认开启需要关闭时用 headmatter 的mcp: false。stdio 注册示例使用npx slidev时可能遇到 CLI 文档中提到的“包名是slidev/cli”问题按上文安装方式处理。【免费下载链接】slidevPresentation Slides for Developers项目地址: https://gitcode.com/GitHub_Trending/sl/slidev创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考