# Vercel MCP Server

A Model Control Protocol (MCP) server deployed on Vercel that provides a
dice rolling tool.

## Getting Started

### Local Development

1. Install dependencies:

   ```bash
   npm install
   ```

2. Run the development server:

   ```bash
   npm run dev
   ```

3. Your MCP server will be available at `http://localhost:3000/api/mcp`

### Deploy to Vercel

1. Push your code to a GitHub repository
2. Connect your repository to Vercel
3. Deploy with a single click
4. Your MCP server will be available at
   `https://your-project.vercel.app/api/mcp`

## Available Tools

### roll_dice

Rolls an N-sided die and returns the result.

**Parameters:**

- `sides` (number): The number of sides on the die (minimum 2)

**Example Response:**

```json
{
  "content": [
    {
      "type": "text",
      "text": "🎲 You rolled a 4!"
    }
  ]
}
```

## Connecting to MCP Hosts

### Claude Desktop

Add the following to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "vercel-mcp": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-fetch",
        "https://your-project.vercel.app/api/mcp"
      ]
    }
  }
}
```

### Cursor

In Cursor, you can connect to your MCP server through the MCP settings by
adding:

- Server URL: `https://your-project.vercel.app/api/mcp`

## Testing

You can test your MCP server by making HTTP requests to the endpoint. The
server accepts MCP protocol messages over HTTP.

## Project Structure

```text
vercel-mcp/
├── app/
│   └── api/
│       └── mcp/
│           └── route.ts    # MCP handler implementation
├── package.json
├── next.config.js
├── tsconfig.json
└── README.md
```

## Next Steps

- Add more tools to your MCP server
- Customize the dice rolling tool
- Deploy to production on Vercel
- Connect to your favorite MCP host (Claude, Cursor, etc.)