Get the FREE Ultimate OpenClaw Setup Guide →

font

an expert design advisor mcp that finds the best fonts for your project via live research and project scanning.

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio microck-font-mcp node server.js \
  --env MAX_DOWNLOAD_ATTEMPTS="maximum number of strategies to try (default: 10)" \
  --env ALLOW_FREE_FONTS_FALLBACK="set to true to allow google fonts fallback (default: false)"

How to use

font-mcp is an expert design advisor MCP that helps you find, pair, and set up fonts tailored to your project. It performs live research on typography discussions, scans your project for vibe, and hunts down font files to automatically configure your environment. Core tools include consult_font_expert for recommendations based on an described vibe, analyze_project_and_recommend to auto-detect your project vibe, analyze_website to reverse-engineer typography from any URL, and setup_font_config to generate setup code and trigger the font hunter to download fonts automatically. Use these tools to generate a cohesive font stack and an automated config (tailwind or CSS) with downloaded font assets.

How to install

Prerequisites:

  • Node.js installed (recommended LTS)
  • Git (optional for cloning)

Installation steps:

  1. Clone the repository (or install via npm if published as a package): git clone https://github.com/microck/font-mcp.git cd font-mcp

  2. Install dependencies: npm install

  3. Build the project (if a build step exists): npm run build

  4. Run the MCP server: npm start

  5. Verify the server is running (default port may vary by setup) and access the MCP API or CLI tools as documented in the repository.

Notes:

  • If you encounter environment variable issues, ensure you set MAX_DOWNLOAD_ATTEMPTS and ALLOW_FREE_FONTS_FALLBACK as needed before starting the server.

Additional notes

Tips and common considerations:

  • The MCP can restrict to paid fonts by default; set allow_free_fonts_fallback to true only if you want Google fonts as a last resort.
  • Ensure you have licenses for any commercial fonts used in production; the tool performs extensive searches but licensing remains your responsibility.
  • The font hunter uses multiple strategies (CDN/GitHub, community hubs, directory searching). If downloads fail, a HUNTING_INSTRUCTIONS.txt may be generated with targeted queries.
  • Configuration options like maxDownloadAttempts and the fallback flag can be tuned in the mcp_config to balance speed and comprehensiveness.
  • When integrating with Tailwind or CSS, use the output from setup_font_config to streamline your font-face definitions and utility classes.

Related MCP Servers

Sponsor this space

Reach thousands of developers