# Cursor MCP Server - Markdown to JPEG Converter

A local Model Context Protocol (MCP) server for Cursor that enables converting Markdown files to JPEG images. This server supports both regular markdown content and Mermaid diagrams.

## Features

- Convert regular Markdown files to JPEG images
- Convert Mermaid diagrams to JPEG images
- Configurable image dimensions and quality
- Automatic detection of Mermaid diagram syntax
- Clean, styled output for regular markdown content

## Prerequisites

Make sure you have the following installed:

- Node.js (v14 or later)
- npm or yarn
- ImageMagick (`brew install imagemagick`)
- Mermaid CLI (`npm install -g @mermaid-js/mermaid-cli`)

## Installation

1. Clone or copy the project files to your desired location
2. Install dependencies:
   ```bash
   npm install
   ```

## Usage

### Standalone Script

You can use the standalone script to convert markdown files:

```bash
# Convert markdown to JPEG
node md-to-jpeg.js input.md [output.jpeg]

# Convert using the original mermaid-only script
node generate-diagram.js input.md [output.png]
```

### MCP Server

The MCP server provides two tools:

1. **convert_md_to_jpeg**: Convert any markdown file to JPEG
2. **convert_mermaid_to_jpeg**: Convert Mermaid diagrams to JPEG

#### MCP Server Configuration

To use with Cursor, add the following to your MCP configuration:

```json
{
  "mcpServers": {
    "markdown-to-jpeg": {
      "command": "node",
      "args": ["/path/to/your/cursor-mcp/server.js"],
      "env": {}
    }
  }
}
```

#### Running the Server

Start the MCP server:

```bash
npm start
```

Or run directly:

```bash
node server.js
```

## Tools Available

### convert_md_to_jpeg

Convert a markdown file to JPEG image with customizable options.

**Parameters:**
- `input_file` (required): Path to the input markdown file
- `output_file` (optional): Path for the output JPEG file
- `width` (optional): Width of the output image (default: 1200)
- `height` (optional): Height of the output image (default: 800)
- `quality` (optional): JPEG quality 1-100 (default: 90)

### convert_mermaid_to_jpeg

Convert a Mermaid diagram file to JPEG image.

**Parameters:**
- `input_file` (required): Path to the input mermaid file
- `output_file` (optional): Path for the output JPEG file

## Example Usage

### Regular Markdown

```markdown
# My Document

This is a sample markdown document with:

- **Bold text**
- *Italic text*
- `Code snippets`

## Code Block

```javascript
function hello() {
  console.log("Hello, world!");
}
```

> This is a blockquote
```

### Mermaid Diagram

```markdown
```mermaid
graph TD
    A[Start] --> B{Is it?}
    B -->|Yes| C[OK]
    C --> D[Rethink]
    D --> B
    B ---->|No| E[End]
```
```

## Supported Formats

- **Input**: Markdown (.md), Mermaid diagrams
- **Output**: JPEG (.jpeg, .jpg)

## Dependencies

- `@modelcontextprotocol/sdk`: MCP SDK for server implementation
- `puppeteer`: For rendering HTML to images
- `marked`: Markdown parsing
- `@mermaid-js/mermaid-cli`: Mermaid diagram generation
- `imagemagick`: Image format conversion

## Troubleshooting

### Common Issues

1. **"mmdc command not found"**: Install Mermaid CLI globally
   ```bash
   npm install -g @mermaid-js/mermaid-cli
   ```

2. **"convert command not found"**: Install ImageMagick
   ```bash
   brew install imagemagick
   ```

3. **Puppeteer issues**: Make sure Chrome/Chromium is installed and accessible

### Testing

Test the conversion with a sample file:

```bash
npm test
```

Or create a test markdown file and run:

```bash
echo "# Test Document\n\nThis is a test." > test.md
node md-to-jpeg.js test.md
```

## License

MIT License