trackmcp
Back to directory
msabramo

vercel-mcp

View on GitHub

Experiment with deploying die-rolling Streamable HTTP MCP server to Vercel

0 stars TypeScriptOthers Updated Jun 22, 2025

Documentation

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

Frequently asked questions

What is vercel-mcp?

vercel-mcp is Experiment with deploying die-rolling Streamable HTTP MCP server to Vercel

How do I install vercel-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is vercel-mcp open source?

Yes โ€” it is hosted on GitHub at https://github.com/msabramo/vercel-mcp.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP