Typst MCP Server

Servidor MCP de Typst

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona documentación de Typst a Claude Code y otros clientes MCP.

Requisitos previos

• Python 3.12 o superior
• Gestor de paquetes uv

Inicio rápido

Ejecute el siguiente comando para añadir el servidor MCP de Typst a su configuración de Claude Code de ámbito de proyecto:

claude mcp add typst-mcp -s project -- uv run --with "git+https://github.com/FujishigeTemma/typst-mcp" typst-mcp serve

O añádalo manualmente a su archivo de configuración .mcp.json:

{
  "mcpServers": {
    "typst-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/FujishigeTemma/typst-mcp"
        "typst-mcp",
        "serve"
      ],
      "env": {}
    },
  }
}

2. Comience a usar las capacidades de Typst

Una vez configurado, puede pedir a Claude Code que le ayude con la documentación de Typst. Por ejemplo:

Add a Tabel of Contents to index.typ

Explain this Typst syntax: #set page(paper: "a4", margin: 2cm)

Documentación

Herramientas

typst_search

Busque en la documentación de Typst temas, funciones o sintaxis específicos.

Parámetros:

• query (cadena): término o frase de búsqueda para encontrar en la documentación de Typst

Devuelve: lista de secciones de documentación relevantes con títulos, descripciones y rutas de archivo.

Ejemplo:

{
  "name": "typst_search",
  "arguments": {
    "query": "table formatting"
  }
}

typst_browse

Explore la estructura de la documentación de Typst como un árbol jerárquico.

Parámetros:

• depth (entero, opcional): profundidad máxima a recorrer (predeterminado: 0 para profundidad completa)
• sub_directory (cadena, opcional): subdirectorio a explorar (predeterminado: "." para la raíz)

Devuelve: estructura de árbol de archivos y directorios de documentación.

Ejemplo:

{
  "name": "typst_browse",
  "arguments": {
    "depth": 2,
    "sub_directory": "reference"
  }
}

typst_read

Lea el contenido de un archivo de documentación de Typst específico.

Parámetros:

• path (cadena): ruta relativa al archivo de documentación

Devuelve: contenido completo del archivo de documentación especificado en formato markdown.

Ejemplo:

{
  "name": "typst_read",
  "arguments": {
    "path": "reference/layout/table.md"
  }
}

Desarrollo

Configuración del entorno de desarrollo

git clone https://github.com/FujishigeTemma/typst-mcp.git
cd typst-mcp
uv sync --dev

Ejecución de pruebas

uv run --frozen pytest

Formato de código

uv run --frozen ruff format .
uv run --frozen ruff check . --fix

Comprobación de tipos

uv run --frozen ty

Licencia

Licencia MIT: consulte el archivo LICENSE para obtener más detalles.

Proyectos relacionados

• Typst - El sistema de composición tipográfica Typst
• MCP Python SDK - SDK de Protocolo de Contexto de Modelo para Python
• Claude Code - Asistente de codificación impulsado por IA