Typst MCP Server

Typst MCP Server

site icon
2025.04.19 0
Python文档处理代码转换语法验证开发效率
Typst MCP Server 是一个基于 MCP(Model Context Protocol)的实现,旨在帮助 AI 模型与 Typst(一种基于标记的排版系统)进行交互。该服务器提供了 LaTeX 与 Typst 之间的转换、Typst 语法验证以及从 Typst 代码生成图像等功能。
View on GitHub

Overview

基本能力

产品定位

Typst MCP Server 是一个用于 AI 模型与 Typst 排版系统交互的工具集,主要提供文档处理、代码转换和验证等功能。

核心功能

  1. 文档章节列表与获取
  2. list_docs_chapters():列出 Typst 文档的所有章节。
  3. get_docs_chapter(route):获取特定章节的内容。
  4. LaTeX 与 Typst 转换
  5. latex_snippet_to_typst(latex_snippet):将 LaTeX 代码转换为 Typst 代码。
  6. Typst 语法验证
  7. check_if_snippet_is_valid_typst_syntax(typst_snippet):验证 Typst 代码的语法正确性。
  8. Typst 代码渲染
  9. typst_to_image(typst_snippet):将 Typst 代码渲染为 PNG 图像。

适用场景

  1. AI 模型需要与 Typst 文档交互时。
  2. 需要将 LaTeX 代码转换为 Typst 代码的场景。
  3. 需要验证 Typst 代码语法或渲染 Typst 代码为图像的场景。

使用教程

使用依赖

  1. 安装 uv
  2. 安装 Typst。

安装教程

  1. 克隆仓库: bash git clone https://github.com/johannesbrandenburger/typst-mcp.git
  2. 克隆 Typst 仓库: bash git clone https://github.com/typst/typst.git
  3. 生成文档: bash cargo run --package typst-docs -- --assets-dir ../typst-mcp/typst-docs --out-file ../typst-mcp/typst-docs/main.json
  4. 安装依赖: bash uv sync

调试方式

  1. 运行服务器: bash python server.py
  2. 或在 Claude Desktop 中安装: bash mcp install server.py
  3. 或在 VS Code 中使用 Agent 模式。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。