# 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.)
