Unified MCP server for the FYIPedia developer tools ecosystem. One server gives AI assistants access to 53 tools from 10 packages -- color conversion, emoji metadata, symbol encoding, Unicode lookup, Google Fonts, distance calculation, timezone operations, Korean romanization, unit conversion, and holiday dates.

One config, 53 tools. Works with Claude Desktop, Cursor, Windsurf, Continue, and any MCP-compatible client. Each package is loaded lazily -- only installed packages register their tools.

• Install
• Integration Guides
  • Claude Desktop
  • Cursor
  • Windsurf
  • Claude Code
  • Standalone
• What You Can Do
  • Color Analysis
  • Text & Encoding
  • Geography & Time
  • Reference Data
• Available Tools (53 total)
  • Color Tools (9 tools)
  • Emoji Tools (7 tools)
  • Symbol Tools (3 tools)
  • Unicode Tools (4 tools)
  • Font Tools (6 tools)
  • Distance Tools (5 tools)
  • Time Tools (5 tools)
  • Unit Tools (4 tools)
  • Name Tools (4 tools)
  • Holiday Tools (5 tools)
• Architecture
• Features
• Also Available as CLI
• FYIPedia Developer Tools
• Links
• License

pip install "fyipedia-mcp[all]"              # All 53 tools from 10 packages
pip install "fyipedia-mcp[color,distance]"   # Just color + distance (14 tools)
pip install "fyipedia-mcp[color,emoji,font]" # Pick any combination
pip install fyipedia-mcp                     # Core only (no tools)

Requires Python 3.10+. Each package is an optional dependency.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
    "mcpServers": {
        "fyipedia": {
            "command": "python",
            "args": ["-m", "fyipedia_mcp.server"]
        }
    }
}

Restart Claude Desktop. You should see 53 tools available under "fyipedia".

Add to .cursor/mcp.json in your project root:

{
    "mcpServers": {
        "fyipedia": {
            "command": "python",
            "args": ["-m", "fyipedia_mcp.server"]
        }
    }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
    "mcpServers": {
        "fyipedia": {
            "command": "python",
            "args": ["-m", "fyipedia_mcp.server"]
        }
    }
}

Add to ~/.claude/settings.json:

{
    "mcpServers": {
        "fyipedia": {
            "command": "python",
            "args": ["-m", "fyipedia_mcp.server"]
        }
    }
}

Run the server directly for testing:

python -m fyipedia_mcp.server

AI assistants can use the 9 color tools to answer questions about color accessibility, design systems, and visual perception. Ask your assistant to check whether a text/background combination meets WCAG 2.1 AA or AAA standards, generate a Tailwind-style shade palette from a brand color, simulate how a UI appears to users with protanopia or deuteranopia, or mix two colors in perceptual Lab space for accurate blending.

"Check if #1A1A2E text on #F0F0F0 background passes WCAG AA"
"Generate a shade palette from our brand blue #3B82F6"
"How does #FF5733 look to someone with color blindness?"
"What's the complementary color of #8B5CF6?"

Learn more: ColorFYI

The emoji, Unicode, and symbol tools give AI assistants access to 3,953 emoji metadata records, 17 Unicode encoding formats, and 11 symbol encoding representations. Your assistant can look up any emoji by keyword or character, encode text for HTML/CSS/JavaScript/Python, find Unicode character properties like script and bidirectional class, and reverse-lookup HTML entities.

"What's the Unicode codepoint for the fire emoji?"
"Encode the copyright symbol for use in HTML, CSS, and JavaScript"
"Search for all arrow-related Unicode characters"
"What HTML entity represents the hearts symbol?"

Learn more: EmojiFYI · UnicodeFYI · SymbolFYI

The 10 distance and time tools let AI assistants calculate great-circle distances using the Haversine formula, determine compass bearings between coordinates, find geographic midpoints, estimate travel times by car/train/plane, and handle timezone conversions across all IANA zones. Assistants can also find overlapping business hours across multiple time zones and look up sunrise/sunset times for any location.

"How far is it from Seoul to Tokyo, and what's the flight time?"
"What time is it in New York when it's 9 AM in Seoul?"
"Find overlapping business hours between London, Tokyo, and San Francisco"
"When is sunrise today in Paris?"

Learn more: DistanceFYI · TimeFYI

The unit, font, holiday, and name tools provide AI assistants with structured reference data. Convert between 220 units across 20 measurement categories with Decimal precision. Look up Google Fonts metadata, CSS import snippets, and font pairing recommendations. Check public holidays for 100+ countries, calculate Easter dates, and find specific weekday occurrences. Romanize Korean text using the official Revised Romanization system and look up Five Elements for CJK stroke counts.

"Convert 185 centimeters to feet and inches"
"What Google Fonts pair well with Inter for body text?"
"Is December 25th a holiday in Japan?"
"Romanize the Korean name 김민준"

Learn more: UnitFYI · FontFYI · HolidayFYI · NameFYI

FYIPedia MCP uses a hub aggregation pattern. Each package has its own standalone MCP server. The hub collects all tools into a single server:

fyipedia-mcp (hub server)
│
├── colorfyi.mcp_server     →  9 tools prefixed with colorfyi_
├── emojifyi.mcp_server     →  7 tools prefixed with emojifyi_
├── symbolfyi.mcp_server    →  3 tools prefixed with symbolfyi_
├── unicodefyi.mcp_server   →  4 tools prefixed with unicodefyi_
├── fontfyi.mcp_server      →  6 tools prefixed with fontfyi_
├── distancefyi.mcp_server  →  5 tools prefixed with distancefyi_
├── timefyi.mcp_server      →  5 tools prefixed with timefyi_
├── namefyi.mcp_server      →  4 tools prefixed with namefyi_
├── unitfyi.mcp_server      →  4 tools prefixed with unitfyi_
└── holidayfyi.mcp_server   →  5 tools prefixed with holidayfyi_
                               ──
                               52 tools total

How it works:

1. Hub defines a catalog of 10 (package_name, module_path) entries
2. At startup, importlib.import_module() loads each package's MCP module
3. Tools are extracted from each package's FastMCP._tool_manager._tools
4. Each tool is re-registered on the hub with a {package}_ prefix to avoid collisions
5. Missing packages are silently skipped -- partial installation works fine

Why a hub? Instead of configuring 10 separate MCP servers, you configure one. AI assistants see all tools in a single namespace. Install only the packages you need, and only those tools appear.

Standalone mode -- each package can also run its own MCP server independently:

{
    "mcpServers": {
        "colorfyi": {
            "command": "python",
            "args": ["-m", "colorfyi.mcp_server"]
        }
    }
}

• 53 tools from 10 packages: Color, emoji, symbol, Unicode, font, distance, time, name, unit, holiday
• One config: Single MCP server entry instead of 10 separate configurations
• Lazy loading: Only installed packages register their tools -- no bloat
• Flexible installation: Install all tools or pick specific packages
• Tool name prefixing: Automatic {package}_ prefix prevents collisions
• Graceful degradation: Missing packages are silently skipped
• MCP v1.0 compatible: Works with any MCP client (Claude, Cursor, Windsurf, Continue, etc.)
• Markdown responses: All tools return formatted markdown for readable AI output
• Type-safe: Full type annotations, strict mypy, PEP 561 compliant
• Zero lock-in: Each package's MCP server also works standalone

Use all 10 tools from the terminal via the unified CLI:

pip install "fyipedia[all]"
fyi color info FF6B35
fyi distance calc --lat1 37.57 --lon1 126.98 --lat2 35.68 --lon2 139.65

See the fyipedia README for the full command reference.

Part of the FYIPedia open-source developer tools ecosystem:

• Model Context Protocol -- MCP specification
• FYIPedia GitHub Organization -- All repositories
• fyipedia CLI -- Terminal interface for all 10 tools
• awesome-fyi -- Curated list of FYIPedia resources
• Source Code -- MIT licensed

MIT