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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/typst-mcp-server/raw/index.md(查看排版版本)