msabramo/vercel-mcp

3.2

If you are the rightful owner of vercel-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a comprehensive overview of a Model Control Protocol (MCP) server deployed on Vercel, which includes a dice rolling tool.

Tools

roll_dice
Rolls an N-sided die and returns the result.

Vercel MCP Server

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

Getting Started

Local Development

Install dependencies:
```
npm install
```
Run the development server:
```
npm run dev
```
Your MCP server will be available at http://localhost:3000/api/mcp

Deploy to Vercel

Push your code to a GitHub repository
Connect your repository to Vercel
Deploy with a single click
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:

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

Connecting to MCP Hosts

Claude Desktop

Add the following to your Claude Desktop configuration:

{
  "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

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