Typst MCP Server

让AI助手帮你直接操作Typst文档,实现转换、验证和图像生成。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Typst MCP Server。
它的用途是:让AI助手帮你直接操作Typst文档,实现转换、验证和图像生成。
完整的 Skill 内容见:https://321skill.com/skills/typst-mcp-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把这段LaTeX数学公式转换成Typst格式,并生成一张300dpi的PNG图片插入到文档里。”,它会通过Typst MCP Server解析你的请求,调用本地Typst引擎处理公式,完成格式转换并生成高清图片,最后将图片路径和嵌入代码提供给你。或者,你可以说:“检查一下我这份报告.typ文件的语法有没有错误。”,AI会读取文件并通过服务器进行验证,反馈具体的语法错误和行号。

介绍

Typst MCP Server 实现了一个MCP(Model Context Protocol)服务器,它充当了AI助手(如Claude)与Typst排版系统之间的桥梁。通过这个Skill,AI可以直接读取、修改、验证Typst文档,并调用Typst引擎进行编译和图像生成,从而将AI强大的理解和生成能力无缝融入专业的文档编写流程。

使用方式非常简单:在你的AI助手(支持MCP协议的Claude Desktop、Cursor等)中配置并启用此MCP服务器后,AI就获得了与Typst交互的能力。你可以直接要求AI“帮我把这个Markdown转换成Typst格式”、“检查一下我的Typst代码语法”或“为这个公式生成一张图片”。AI会通过此服务器调用本地Typst环境执行相应操作,并将结果返回给你。

这个Skill非常适合经常使用Typst进行文档创作、学术写作或技术文档编写的用户。无论是需要快速将其他格式内容转换为Typst,还是在编写复杂文档时需要语法检查和实时预览,亦或是需要为文档内容(如数学公式)生成高质量的嵌入图像,它都能提供强大的辅助。

建议在使用前确保本地已正确安装Typst。由于它直接操作你的本地文件和Typst环境,请确保在可信的AI助手会话中使用,并注意处理可能包含敏感信息的文档。初次配置时请仔细阅读项目的README,确保MCP服务器配置正确。

核心特点

这是首个将MCP协议与Typst深度集成的工具,使AI能直接理解和操作Typst语法,进行格式转换、语法验证和动态图像生成,而不仅仅是文本层面的建议。它让AI从“文档顾问”变成了“文档协作者”,能直接执行编译和生成任务。

注意事项

不适合不熟悉Typst基础语法或未在本地安装Typst环境的用户,也无法处理在线或远程的Typst文档。

常见问题

Typst MCP Server 能做什么?

它能让AI助手直接读取、修改、验证Typst代码,并调用Typst引擎将文档编译为PDF或生成数学公式等内容的图片。

我需要先安装Typst吗?

是的,此Skill需要依赖本地安装的Typst命令行工具来执行核心的编译和生成功能。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/typst-mcp-server/raw/index.md 读取 Typst MCP Server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。