# Logo.dev MCP Server

An MCP (Model Context Protocol) server for the Logo.dev API that enables searching for and retrieving company logos. Ready for deployment on [Smithery](https://smithery.ai/).

## Features

- **Search for logos**: Search for company logos by brand or company name
- **Get logo URLs**: Retrieve direct logo image URLs with customization options
- **Multiple formats**: Support for PNG, JPG, and WebP formats
- **Theme variants**: Light and dark theme options
- **Customizable**: Size, format, theme, and greyscale options
- **Smithery Ready**: Deploy directly to Smithery with automatic configuration

## Tools

### `search_logos`

Search for company logos by brand name or company name.

**Parameters:**
- `query` (string, required): The brand or company name to search for

**Returns:** A list of matching companies with their domains and logo URLs.

**Example:**
```json
{
  "query": "Google",
  "count": 1,
  "results": [
    {
      "name": "Google",
      "domain": "google.com",
      "logoUrl": "https://img.logo.dev/google.com?token=..."
    }
  ]
}
```

### `get_logo_url`

Get a direct logo image URL for a specific domain with customization options.

**Parameters:**
- `domain` (string, required): The company domain (e.g., 'google.com')
- `size` (string, optional): Logo size/dimensions
- `format` (string, optional): Image format - "png", "jpg", or "webp" (default: png)
- `theme` (string, optional): Logo theme - "light" or "dark"
- `greyscale` (boolean, optional): Convert logo to greyscale (default: false)

**Returns:** Logo URL with the specified options.

**Example:**
```json
{
  "domain": "apple.com",
  "logoUrl": "https://img.logo.dev/apple.com?token=...&format=webp&theme=dark",
  "options": {
    "size": "default",
    "format": "webp",
    "theme": "dark",
    "greyscale": false
  }
}
```

## Smithery Deployment

This server is designed for [Smithery](https://smithery.ai/) deployment:

1. Push this code to a Git repository
2. Connect the repository to Smithery
3. Smithery will automatically detect the TypeScript runtime
4. Enter your Logo.dev API key when prompted
5. Deploy and use!

## Local Usage

### Prerequisites

- Node.js 20 or higher
- A Logo.dev API key (get one at [logo.dev](https://logo.dev))

### Installation

```bash
npm install
npm run build
```

### STDIO Mode (for Claude Desktop)

```bash
export LOGO_DEV_API_KEY="your-api-key-here"
node build/index.js
```

### Claude Desktop Configuration

Add to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "logo-dev": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-logo-dev/build/index.js"],
      "env": {
        "LOGO_DEV_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

## Development

### Watch mode

```bash
npm run watch
```

### Testing with MCP Inspector

```bash
npm run inspector
```

## API Reference

This server uses the [Logo.dev API](https://docs.logo.dev/):
- Search endpoint: `https://api.logo.dev/search?q={query}`
- Image CDN: `https://img.logo.dev/{domain}`

## License

MIT