mcpField
M
MCP example Netlify Express

MCP example Netlify Express

Local
github.com/srikaran7Developer Tools0Updated 78w ago
Repository

About MCP example Netlify Express

MCP example Netlify Express is a small demonstration of running an MCP server as a Netlify Function with Express. It is intended for developers exploring serverless deployment and route mapping for MCP endpoints.

Key features

  1. 01Run an MCP server with Netlify Functions
  2. 02Route MCP requests through Express
  3. 03Map a custom /mcp URL with redirects
  4. 04Deploy the example to a Netlify project

Use cases

  1. 01Prototype a serverless MCP endpoint
  2. 02Test Express route mapping on Netlify
  3. 03Explore a deployable MCP example

MCP support

It demonstrates an MCP server hosted by Netlify Functions and accessed through an Express route. The example maps /mcp to the serverless function using Netlify redirects.

#mcp#netlify#serverless

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "srikaran7": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Netlify Examples

MCP example Netlify Express

View this demo site: https://mcp-example-express.netlify.app/

Netlify Status

About this example site

This site shows a very a basic example of developing and running serverless MCP using Netlify Functions. It includes links to a deployed serverless function and an example of accessing the function using a customized URL.

Importantly, because of how Express handles mapping routes, ensure you set the netlify.toml redirects to the correct path. In this example we have the following to ensure /mcp catches all of the requests to this server:

[[redirects]]
  force = true
  from = "/mcp"
  status = 200
  to = "/.netlify/functions/express-mcp-server"

Speedily deploy your own version

Deploy your own version of this example site, by clicking the Deploy to Netlify Button below. This will automatically:

  • Clone a copy of this example from the examples repo to your own GitHub account
  • Create a new project in your Netlify account, linked to your new repo
  • Create an automated deployment pipeline to watch for changes on your repo
  • Build and deploy your new site
  • This repo can then be used to iterate on locally using netlify dev

Deploy to Netlify

Install and run the examples locally

You can clone this entire examples repo to explore this and other examples, and to run them locally.


# 1. Clone the examples repository to your local development environment
git clone [email protected]:netlify/examples

# 2. Move into the project directory for this example
cd examples/mcp/express-mcp

# 3. Install the Netlify CLI to let you locally serve your site using Netlify's features
npm i -g netlify-cli

# 4. Serve your site using Netlify Dev to get local serverless functions
netlify dev

# 5. While the site is running locally, open a separate terminal tab to run the MCP inspector or client you desire
npx @modelcontextprotocol/inspector npx mcp-remote@next http://localhost:8888/mcp

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.