# Fumadocs MCP Server

An MCP (Model Context Protocol) server that provides AI tools with access to [Fumadocs](https://fumadocs.dev) documentation. This makes it easier for AI assistants to help you integrate Fumadocs into your existing projects.

## Features

- **Search documentation** - Find relevant docs by keyword
- **Browse topics** - Explore documentation sections
- **Fetch pages** - Get full content of any documentation page
- **Setup guides** - Get framework-specific installation instructions
- **Component docs** - Get UI component documentation with props and examples

## Installation

### Using npx (recommended)

```bash
npx fumadocs-mcp
```

### Global installation

```bash
npm install -g fumadocs-mcp
fumadocs-mcp
```

### From source

```bash
git clone https://github.com/k4cper-g/fumadocs-mcp
cd fumadocs-mcp
npm install
npm run build
```

## Configuration

### Claude Desktop

Add to your Claude Desktop configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "fumadocs": {
      "command": "npx",
      "args": ["fumadocs-mcp"]
    }
  }
}
```

Or if installed from source:

```json
{
  "mcpServers": {
    "fumadocs": {
      "command": "node",
      "args": ["/path/to/fumadocs-mcp/build/index.js"]
    }
  }
}
```

### Claude Code

The MCP will be automatically available when configured in Claude Desktop.

## Available Tools

### `list_topics`

Browse available documentation sections and topics.

```
Parameters:
- section (optional): "all" | "cli" | "headless" | "framework" | "mdx" | "ui"
```

### `search_docs`

Search documentation by keyword.

```
Parameters:
- query (required): Search query string
- section (optional): Filter to a specific section
```

### `get_page`

Fetch the full content of a documentation page.

```
Parameters:
- path (required): Documentation path (e.g., "/docs/manual-installation/next")
```

### `get_setup_guide`

Get a complete setup guide for adding Fumadocs to an existing project.

```
Parameters:
- framework (required): "next" | "react-router" | "tanstack-start" | "waku"
- includeUI (optional): Whether to include UI setup instructions (default: true)
```

### `get_component`

Get documentation for a specific UI component.

```
Parameters:
- component (required): Component name (e.g., "accordion", "tabs", "codeblock")
```

## Example Usage

Once configured, you can ask Claude things like:

- "How do I add Fumadocs to my existing Next.js project?"
- "Show me how to use the Tabs component in Fumadocs"
- "Search for documentation about internationalization"
- "What components are available in Fumadocs UI?"

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test with MCP Inspector
npm run inspector
```

## License

MIT