Typst Universe MCP Server
An MCP (Model Context Protocol) server that provides AI assistants with access to the Typst Universe package registry. This allows AI models to search for packages, get package details, and explore the Typst ecosystem.
Features
This MCP server provides the following tools:
| Tool | Description |
|---|---|
🔍 search_packages | Search for Typst packages by query, category, or kind |
📦 get_package_details | Get detailed info about a specific package |
📂 list_categories | List all available package categories |
⭐ get_featured_packages | Get featured/popular packages |
Installation
From npm (recommended)
npm install -g typst-universe-mcp
From source
git clone https://github.com/W1seGit/typst-universe-mcp.git
cd typst-universe-mcp
npm install
npm run build
Configuration
Claude Desktop
Add this to your Claude Desktop config file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"typst-universe": {
"command": "npx",
"args": ["-y", "typst-universe-mcp"]
}
}
}
Or if installed from source:
{
"mcpServers": {
"typst-universe": {
"command": "node",
"args": ["/path/to/typst-universe-mcp/dist/index.js"]
}
}
}
Other MCP Clients
The server uses stdio transport. Start it with:
npx typst-universe-mcp
# or
node /path/to/dist/index.js
Usage Examples
Once connected to an AI assistant, you can ask:
- "Search for Typst packages for creating diagrams"
- "Get details about the cetz package"
- "What categories are available in Typst Universe?"
- "Show me featured Typst packages"
- "Find math-related Typst packages"
- "Search for presentation templates"
Tool Details
search_packages
Search for packages in Typst Universe.
Parameters:
query(string, optional): Search text (e.g., "math", "diagram")kind(string, optional):"packages"or"templates"(default:"packages")category(string, optional): Filter by category (e.g., "visualization", "math")limit(number, optional): Max results to return (default: 20)
get_package_details
Get detailed information about a specific package.
Parameters:
packageName(string, required): The exact package name (e.g., "cetz", "polylux")
Returns: Description, authors, categories, repository link, import code, and version history.
list_categories
Lists all available package categories in Typst Universe. No parameters required.
get_featured_packages
Returns a list of featured/popular packages. No parameters required.
Development
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Run production build
npm start
Requirements
- Node.js >= 18.0.0
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Disclaimer
This project is not affiliated with Typst GmbH. It uses web scraping to access publicly available information from Typst Universe.