Typst MCP 서버는 AI 모델이 마크업 기반 조판 시스템인 Typst와 상호작용할 수 있도록 돕는 MCP(Model Context Protocol) 구현체입니다. 이 서버는 LaTeX와 Typst 간 변환, Typst 문법 검증, Typst 코드로부터 이미지 생성 도구를 제공합니다.

사용 가능한 도구

⚠️ 현재 모든 기능은 tools로 구현되어 있는데, 이는 커서와 VS 코드가 아직 다른 원시 함수들을 처리할 수 없기 때문입니다.

서버는 다음과 같은 도구를 제공합니다:

1. list_docs_chapters(): Typst 문서에 있는 모든 챕터를 나열합니다.

• LLM이 문서 개요를 확인하고 읽을 챕터를 선택할 수 있게 합니다.
• LLM은 해당 과제에 따라 읽을 관련 장을 선택해야 합니다.

2. get_docs_chapter(route): Typst 문서에서 특정 챕터를 가져옵니다.

• LLM이 선택한 챕터를 기반으로 이 도구는 챕터의 내용을 검색합니다.
• 여러 챕터를 동시에 확인할 수 있는 get_docs_chapters(routes: list)로도 제공됩니다.

3. latex_snippet_to_typst(latex_snippet): Pandoc을 사용해 LaTeX 코드를 Typst로 변환합니다.

• LLM은 Typst보다 LaTeX 작성에 더 뛰어나기 때문에, 이 도구는 LaTeX 코드를 Typst로 변환하는 데 도움을 줍니다.

Typst MCP Server

Typst MCP Server is an MCP (Model Context Protocol) implementation that helps AI models interact with Typst, a markup-based typesetting system. The server provides tools for converting between LaTeX and Typst, validating Typst syntax, and generating images from Typst code.

Available Tools

⚠️ Currently all the functionality is implemented as tools, because Cursor and VS Code are not able to handle the other primitives yet.

The server provides the following tools:

1. list_docs_chapters(): Lists all chapters in the Typst documentation.

   • Lets the LLM get an overview of the documentation and select a chapter to read.
   • The LLM should select the relevant chapter to read based on the task at hand.

2. get_docs_chapter(route): Retrieves a specific chapter from the Typst documentation.

   • Based on the chapter selected by the LLM, this tool retrieves the content of the chapter.
   • Also available as get_docs_chapters(routes: list) for retrieving multiple chapters at once.

3. latex_snippet_to_typst(latex_snippet): Converts LaTeX code to Typst using Pandoc.

   • LLMs are better at writing LaTeX than Typst, so this tool helps convert LaTeX code to Typst.
   • Also available as latex_snippets_to_typst(latex_snippets: list) for converting multiple LaTeX snippets at once.

4. check_if_snippet_is_valid_typst_syntax(typst_snippet): Validates Typst code.

   • Before sending Typst code to the user, the LLM should check if the code is valid.
   • Also available as check_if_snippets_are_valid_typst_syntax(typst_snippets: list) for validating multiple Typst snippets at once.

5. typst_to_image(typst_snippet): Renders Typst code to a PNG image.

   • Before sending complex Typst illustrations to the user, the LLM should render the code to an image and check if it looks correct.
   • Only relevant for multi modal models.

Getting Started

• Clone this repository

  • git clone https://github.com/johannesbrandenburger/typst-mcp.git

• Clone the typst repository

  • git clone https://github.com/typst/typst.git

• Run the docs generation in the typst repository

  • cargo run --package typst-docs -- --assets-dir ../typst-mcp/typst-docs --out-file ../typst-mcp/typst-docs/main.json
    • Make sure to adjust the path to your local clone of the typst-mcp repository
    • This will generate the main.json and the assets in the typst-docs folder

• Install required dependencies: uv sync (install uv if not already installed)

• Install Typst

Running the Server

Local Installation

Execute the server script:

python server.py

Or install it in Claude Desktop with MCP:

mcp install server.py

Or use the new agent mode in VS Code: