symbols-mcp-server
Convert Angular components to Symbols/DOMQL v3 using the convert_to_symbols tool.
Integrate with Windsurf (Codeium's IDE) as an MCP platform.
Convert React components to Symbols/DOMQL v3 using the convert_to_symbols tool.
Optional integration for vector-based documentation search using Supabase database.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Symbols MCP Server
An MCP (Model Context Protocol) server that exposes the Symbols/DOMQL v3 AI assistant capabilities to any MCP-compatible platform — Cursor, Claude Code, Windsurf, and more.
Features
Tools
Tool | Description |
| Generate a Symbols/DOMQL v3 component from natural language |
| Generate a full page with routing support |
| Scaffold a complete multi-file Symbols project |
| Convert React/Angular/Vue/HTML to Symbols/DOMQL v3 |
| Search Symbols documentation (vector or local) |
| Explain any Symbols concept with examples |
| Review code for v3 compliance and best practices |
| Generate design system files (colors, spacing, themes, icons) |
Resources
Resource URI | Description |
| Complete DOMQL v3 syntax reference |
| Project folder structure conventions |
| Modern UI/UX design direction |
| React/Angular/Vue → Symbols migration |
| DOMQL v2 → v3 changes |
| CLI setup and quickstart |
| Spacing token reference table |
| Built-in primitive components |
| Event handler reference |
Prompts
Prompt | Description |
| Template for component generation |
| Template for framework migration |
| Template for project scaffolding |
| Template for code review |
Related MCP server: bunge-ds-mcp
Installation
Quick Start (No API Keys Required!)
Clone the repository:
git clone https://github.com/baronsilver/symbols-mcp-server.git
cd symbols-mcp-serverInstall dependencies:
pip install uv
uv sync
npm i @symbo.ls/cli -g
smbls create your-projectIMPORTANT: For now, delete the docs folder inside your project folder after creation
Configure:
cp .env.example .env
# Edit .env and add both:
# - SYMBOLS_MCP_URL (contact maintainer for public server URL)
# - LLM_MODEL=google/gemini-3-flash-previewPlatform Integration
Claude Code
claude mcp add symbols-mcp -- uv run --directory C:\repos\symbols-mcp-server symbols-mcpOr manually edit ~/UserName/.claude.json:
{
"mcpServers": {
"symbols-mcp": {
"command": "python",
"args": [
"-m",
"uv",
"run",
"--directory",
"C:\\repos\\symbols-mcp-server",
"symbols-mcp"
]
}
}
}Cursor
Add to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):
{
"mcpServers": {
"symbols-mcp": {
"command": "python",
"args": [
"-m",
"uv",
"run",
"--directory",
"C:\\repos\\symbols-mcp-server",
"symbols-mcp"
]
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"symbols-mcp": {
"command": "python",
"args": [
"-m",
"uv",
"run",
"--directory",
"C:\\repos\\symbols-mcp-server",
"symbols-mcp"
]
}
}
}Development
Restart your platforms after updating the MCP settings. Once loaded, it should automatically run the MCP. Ask your AI to do the quick test with the MCP to see if it works properly.
Environment Variables
Variable | Required | Default | Description |
| Yes | — | API key for OpenRouter (powers AI generation) |
| No | — | Supabase project URL for vector search |
| No | — | Supabase service role key |
| No |
| AI model to use via OpenRouter |
| No |
| Path to skills markdown files |
Architecture
symbols-mcp-server/
├── pyproject.toml # Project config and dependencies
├── .env.example # Environment variable template
├── README.md # This file
└── symbols_mcp/
├── __init__.py
├── server.py # MCP server with tools, resources, prompts
└── skills/ # Bundled Symbols knowledge base
├── CLAUDE.md # DOMQL v3 complete reference
├── SYMBOLS_LOCAL_INSTRUCTIONS.md # Project structure rules
├── DESIGN_DIRECTION.md # UI/UX design direction
├── MIGRATE_TO_SYMBOLS.md # Framework migration guide
├── DOMQL_v2-v3_MIGRATION.md # v2→v3 changes
└── QUICKSTART.md # CLI quickstartThe server reads skills files at startup and uses them as context for all AI-powered tools.
When Supabase is configured, the search_symbols_docs tool also queries the vector database
for additional documentation matches.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Hosted MCP server for live public-data APIs and Skills for AI agents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseAqualityDmaintenanceA comprehensive MCP server providing tools for AI agents to interact with code, including reading symbols, importing modules, replacing text, and sending OS notifications.349 npm10MIT
- AlicenseAqualityCmaintenanceMCP server that exposes the @bunge/ds-components design system catalog, allowing AI assistants to list, search, and retrieve component details including inputs, outputs, usage examples, and import instructions.4MIT
- AlicenseBqualityBmaintenanceMCP server for syntx.ai AI platform that enables chat, image generation, model catalog, and account management through any MCP-compatible assistant.5812MIT

symbols-mcpofficial
AlicenseAqualityBmaintenanceMCP server for the Symbols.app platform, enabling AI coding assistants to search docs, generate components, audit code, manage projects, and deploy via the smbls stack.28686 npm1Creative Commons Attribution Non Commercial 4.0 International