Typst Universe

Provides an MCP server for Typst Universe to search, fetch package details, list categories, and surface featured packages.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "w1segit-typst-universe-mcp": {
      "command": "npx",
      "args": [
        "typst-universe-mcp"
      ]
    }
  }
}

You can run an MCP server that gives AI assistants access to the Typst Universe package registry. It enables searching for Typst packages, viewing package details, listing categories, and discovering featured packages, all through a standard MCP transport.

How to use

Connect your MCP client to the Typst Universe MCP Server using the stdio transport. Start the server and then point your client at it. Once connected, you can perform practical tasks such as searching for Typst packages by query, category, or kind; retrieving detailed information about a specific package; listing all available categories; and viewing a curated set of featured packages. Use these capabilities to quickly gather package data for your AI workflows or documentation tasks.

How to install

You need Node.js v18 or newer installed on your system. Then install the MCP server package globally or run it from source as described.

# Prerequisite: ensure Node.js is installed
node -v
npm -v

# Install the MCP server from npm (recommended)
npm install -g typst-universe-mcp

# Run the MCP server via npx (stdin/stdio transport)
npx typst-universe-mcp

# Or run from source after cloning and building
# git clone https://github.com/W1seGit/typst-universe-mcp.git
# cd typst-universe-mcp
# npm install
# npm run build
# node dist/index.js

Configuration and starting tips

To connect with Claude Desktop or other MCP clients, configure the MCP server in your client’s settings. If you are using Claude Desktop on Windows, add an MCP server entry that uses the stdio transport with the npx command. If you install from source, you can run the server with node and the built distribution.

{
  "mcpServers": {
    "typst_universe": {
      "command": "npx",
      "args": ["typst-universe-mcp"]
    }
  }
}

Starting from source or when using a local build

If you cloned the repository and built the project, start the server with the runtime command that points to the built entry point.

node /path/to/dist/index.js

Available tools

search_packages

Search for Typst packages by query, category, or kind with optional limits.

get_package_details

Retrieve detailed information about a specific Typst package, including authors, categories, repository link, import code, and version history.

list_categories

List all available package categories in Typst Universe.

get_featured_packages

Return a list of featured or popular Typst packages.