open-index/open-npm huggingface dataset:
npm package: @fontofweb/mcp
Description: MCP Server and CLI installer for Font of Web
Latest version: 1.0.3

# @fontofweb/mcp

MCP Server and CLI installer for Font of Web - design inspiration, font discovery, and design token extraction.

## Quick Start

```bash
npx @fontofweb/mcp install --token <your-token>
```

Get your access token at: https://fontofweb.com/mcp

## Usage

### Install Command

```bash
npx @fontofweb/mcp install --token <token> [options]
```

**Token input (one of):**
- `--token, -t`: Your Font of Web API token
- `FONTOFWEB_MCP_TOKEN`: Environment variable fallback
- Interactive prompt: If no token is provided and terminal is interactive

**Optional:**
- `--assistants, -a`: Comma-separated list of assistants or `all` (default: all)
- `--cwd`: Project directory for skill installation (default: current directory)
- `--dry-run`: Preview changes without writing files
- `--help, -h`: Show help
- `--version, -v`: Show version

### Examples

```bash
# Install for all assistants
npx @fontofweb/mcp install --token abc123

# Install for specific assistants only
npx @fontofweb/mcp install --token abc123 --assistants cursor,codex

# Dry run to preview changes
npx @fontofweb/mcp install --token abc123 --dry-run

# Install skills to specific directory
npx @fontofweb/mcp install --token abc123 --cwd ./my-project
```

## Supported Assistants

### Auto-Installed (File-based)

The following assistants are automatically configured:

| Assistant | Config Location |
|-----------|----------------|
| Cursor | `~/.cursor/mcp.json` |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
| Codex | `~/.codex/config.toml` |
| OpenCode | `~/.opencode/mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
| Zed | `~/.config/zed/settings.json` |
| Gemini CLI | `~/.gemini/settings.json` |
| Kiro | `~/.kiro/settings/mcp.json` |
| Roo Code | `~/.roocode/mcp.json` |

### Manual Setup Required

The following assistants require manual configuration:

- **VS Code**: Open Settings → MCP Servers → Add "fontofweb" with URL `https://mcp.fontofweb.com/mcp` and Authorization header
- **Claude Code**: Run `claude config add mcp.fontofweb.url https://mcp.fontofweb.com/mcp`
- **Warp**: Open Warp → Settings → AI → MCP → Add server
- **v0**: Configure in v0 settings under MCP Servers

## Skills Installation

The installer copies the following skill templates to `./skills/` in your project:

- `design-inspiration/SKILL.md` - Search design inspiration by query, color, fonts, or domain
- `font-discovery/SKILL.md` - Discover and research fonts
- `token-export/SKILL.md` - Extract and export design tokens

### Idempotent Updates

The installer safely handles re-runs:
- **Generated files** (with `<!-- FONTofWEB:GENERATED -->` marker): Overwritten on update
- **User-modified files** (no marker): Skipped with warning to preserve your changes

## Exit Codes

- `0`: All selected installs succeeded
- `1`: One or more installs failed (see output for details)
- `2`: Invalid arguments or usage error

## Development

```bash
# Run tests
npm test

# Deploy MCP server
npm run deploy
```

## License

MIT