Typst MCP

🚀 Typst MCP サーバー

Typst MCP サーバーは、MCP（モデルコンテキストプロトコル） の実装で、AI モデルが Typst とやり取りできるようにすることを目的としています。Typst は、マークに基づく組版システムです。このサーバーは、LaTeX を Typst に変換したり、Typst 構文を検証したり、Typst コードから画像を生成したりする機能を提供します。

✨ 主な機能

⚠️ 重要提示

現在、すべての機能は tools の形式で実装されています。Cursor と VS Code は他のタイプのプリミティブをまだサポートしていないためです。

サーバーが提供するツールは以下の通りです。

1. list_docs_chapters()：Typst ドキュメント内のすべての章をリストします。

   • LLM がドキュメントの概要を取得し、読む章を選択できるようにします。
   • LLM は、手元のタスクに関連する章を選択して読むことができます。

2. get_docs_chapter(route)：特定の章の Typst ドキュメント内容を取得します。

   • LLM が選択した章に基づいて、このツールはその章の内容を返します。
   • 同時に get_docs_chapters(routes: リスト) もサポートしており、複数の章の内容を一度に取得できます。

3. latex_snippet_to_typst(latex_snippet)：Pandoc を使用して LaTeX コードを Typst に変換します。

   • LLM は LaTeX を書くのが得意なため、このツールは LaTeX コードを Typst に変換するのに役立ちます。
   • 同時に latex_snippets_to_typst(latex_snippets: リスト) もサポートしており、複数の LaTeX スニペットを一括で変換できます。

4. check_if_snippet_is_valid_typst_syntax(typst_snippet)：Typst コードの構文が正しいかどうかを検証します。

   • Typst コードをユーザーに送信する前に、LLM はコードが有効かどうかをチェックする必要があります。
   • 同時に check_if_snippets_are_valid_typst_syntax(typst_snippets: リスト) もサポートしており、複数の Typst スニペットを一括で検証できます。

5. typst_to_image(typst_snippet)：Typst コードを PNG 画像にレンダリングします。

   • 複雑な Typst イラストをユーザーに送信する前に、LLM はコードを画像にレンダリングし、正しいかどうかを確認する必要があります。
   • マルチモーダルモデルにのみ適用されます。

🚀 クイックスタート

• このリポジトリをクローンします。
  • git clone https://github.com/johannesbrandenburger/typst-mcp.git
• Typst リポジトリ をクローンします。
  • git clone https://github.com/typst/typst.git
• Typst リポジトリでドキュメント生成を実行します。
  • cargo run --package typst-docs -- --assets-dir ../typst-mcp/typst-docs --out-file ../typst-mcp/typst-docs/main.json
    • パスを調整して、ローカルの typst-mcp リポジトリの位置に合わせる必要があります。
    • これにより、main.json と typst-docs フォルダ内のアセットが生成されます。
• 必要な依存関係をインストールします：uv sync（まだインストールされていない場合は、まず uv をインストール してください）。
• Typst をインストールします。

📦 インストール

サーバーの起動

サーバースクリプトを実行します。

python server.py

または、Claude Desktop で MCP を使用してインストールします。

mcp install server.py

または、VS Code の新しいエージェントモードを使用します。 エージェントモード：すべてのユーザーに開放され、MCP をサポート

📚 ドキュメント

⚠️ 重要提示

Typst ドキュメントのスキーマは不安定で、いつでも変更される可能性があります。このスキーマは Typst ソースコードから生成されており、完全性や正確性は保証されません。スキーマが変更された場合、このリポジトリを適宜更新して、ドキュメント機能が正常に動作するようにする必要があります。