MCP 服务器

Font MCP

An expert design advisor MCP server that researches live discussions, scans project files, and automatically downloads font files for your project setup.

README

Font MCP

An expert design advisor MCP server that finds, pairs, and sets up the best fonts for your project.

Font MCP doesn't just list fonts — it researches live discussions (Reddit, Typewolf), scans your project files for "vibe", and automatically hunts down font files for your setup.

Quick Start
Features
Installation
Usage
Tools Reference
Font Hunter Logic
Configuration
How It Works
License

Quick Start

OpenCode

Tell OpenCode:

fetch and follow instructions from https://raw.githubusercontent.com/Microck/font-mcp/master/.opencode/INSTALL.md

Codex

Tell Codex:

fetch and follow instructions from https://raw.githubusercontent.com/Microck/font-mcp/master/.codex/INSTALL.md

Features

Live Research — Searches Reddit (r/typography, r/web_design) and design archives (Typewolf, FontsInUse) for real-world usage examples and expert recommendations.
Project Scanning — Analyzes your package.json and config files to detect your project's "vibe" and technical stack automatically.
Steal This Look — Scans any website URL to identify what fonts they are using and whether they're paid or free.
Auto-Setup — Generates Tailwind or CSS configuration and automatically downloads font files.
Font Hunter v2 — Exhaustive search engine that tries GitHub, GitLab, VK, Archive.org, and open directories to find your font files.
No-Free Fallback — Strictly stays on S-tier/paid fonts unless you explicitly enable free fallback in config.

Installation

Prerequisites

Node.js 18+
npm or your preferred package manager

Build from Source

git clone https://github.com/Microck/font-mcp.git
cd font-mcp
npm install
npm run build

Development

npm run dev

Usage

Tools Reference

Tool	Description
`consult_font_expert`	Get recommendations based on a vibe or description
`analyze_project_and_recommend`	Auto-detect vibe from your project path and recommend fonts
`analyze_website`	Reverse-engineer the typography of any website URL
`setup_font_config`	Generate setup code and download font files automatically

`consult_font_expert`

Get expert font recommendations based on a vibe, project type, or visual description. Uses live research from Reddit, Typewolf, and FontsInUse.

Parameters:

Parameter	Type	Required	Description
`vibe`	string	Yes	Description of the project or aesthetic (e.g., `"luxury"`, `"tech startup"`, `"editorial"`, `"playful"`)
`allow_paid`	boolean	No	Whether to include paid/commercial fonts (default: `true`)

`analyze_project_and_recommend`

Scans the project directory (package.json, config files) to automatically detect the "vibe" and recommend suitable fonts.

Parameters:

Parameter	Type	Required	Description
`project_path`	string	Yes	Absolute path to the project root
`allow_paid`	boolean	No	Whether to include paid/commercial fonts (default: `true`)

`analyze_website`

Analyze a live website URL to identify which fonts it uses ("Steal this look").

Parameters:

Parameter	Type	Required	Description
`url`	string	Yes	The website URL to analyze

`setup_font_config`

Generate CSS or Tailwind configuration and setup instructions for a specific font. Automatically attempts to download the font files for testing purposes (assuming you have a valid license).

Parameters:

Parameter	Type	Required	Description
`font_name`	string	Yes	Name of the font
`is_paid`	boolean	Yes	Whether this is a paid font
`type`	string	No	Output format: `"tailwind"` or `"css"` (default: `"tailwind"`)

Example

{
  "name": "setup_font_config",
  "arguments": {
    "font_name": "Helvetica Now",
    "is_paid": true,
    "type": "tailwind"
  }
}

Font Hunter Logic

The tool assumes you own a valid license for any commercial font. It uses multiple strategies to locate files:

Direct CDN / GitHub raw patterns.
Community sharing hubs (VK, Telegram indices).
Open directory dorking (Google/browser search).
Last resort: Writes a HUNTING_INSTRUCTIONS.txt with specific search queries if auto-download fails.

Configuration

You can tweak the behavior in your MCP config:

Option	Type	Default	Description
`maxDownloadAttempts`	number	`10`	Number of download strategies to try
`downloadTimeoutMs`	number	`30000`	Timeout in milliseconds for each font download request
`outputDir`	string	`'./public/fonts'`	Directory where downloaded font files and hunt artifacts are written
`allowFreeFontsFallback`	boolean	`false`	Set to `true` to allow Google Fonts fallback

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   AI Agent      │────▶│   Font MCP   │────▶│  Research Service │
│  (MCP Client)   │     │   Server     │     │  (Reddit, Typewolf)│
└─────────────────┘     └──────┬───────┘     └──────────────────┘
                               │
                    ┌──────────┼──────────┐
                    ▼          ▼          ▼
            ┌──────────┐ ┌──────────┐ ┌──────────┐
            │ Project  │ │   Web    │ │   Font   │
            │ Scanner  │ │ Detector │ │  Hunter  │
            └──────────┘ └──────────┘ └──────────┘

ResearchService — Queries Reddit, Typewolf, and FontsInUse for live font recommendations.
ProjectScannerService — Reads package.json and config files to detect project vibe and tech stack.
WebFontDetectorService — Scrapes websites to identify font families in use.
ConfigGeneratorService — Produces Tailwind or vanilla CSS configuration snippets.
FontHunterService — Multi-strategy font file downloader (CDN, GitHub, community hubs, open directories).