Metadata-Version: 2.4
Name: frontend-dev-mcp
Version: 0.1.1
Summary: Frontend Development MCP Server
Requires-Python: >=3.12
Requires-Dist: mcp[cli]
Requires-Dist: rich
Description-Content-Type: text/markdown

# Frontend Development MCP Server

Model Context Protocol (MCP) server built with `FastMCP` for frontend development workflows.

## Features & Tools

- `get_design_system_guide(type)`: Pros/cons of design systems ('utility-first', 'component-library', 'headless').
- `get_color_palette(primary_hex)`: Generate full complementary and analogous color palettes.
- `get_accessibility_checklist()`: Essential a11y checklist.
- `get_performance_tips(focus_area)`: Performance tips for 'images', 'javascript', or 'css'.
- `get_agent_skill(skill_name)`: Reads agent instructions locally from `.agents/skills`.
- `ask_gemini_cli(prompt)`: Calls local `gemini` CLI securely via subprocess (no API key stored in code). Forces short outputs using "caveman mode".

## Prompts

- `frontend_project_kickoff`: Interactive checklist to plan new architectures.

## Run / Install (with `uv`)

No virtual environment needed if using `uv`. Just run:
```bash
uv run server.py
```

## Connect to MCP Client (Claude Desktop, etc)

Add this to your MCP config (e.g. `claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "frontend-dev-server": {
      "command": "uv",
      "args": [
        "run",
        "E:/absolute/path/to/server.py"
      ],
      "env": {}
    }
  }
}
```

## Testing via Inspector

```bash
npx @modelcontextprotocol/inspector uv run server.py
```
