Remote MCP Server on Cloudflare Workers

This repository contains a Cloudflare Workers-based remote Model Context Protocol (MCP) server example. It is designed to host a remote MCP service that can be used by AI clients, Playground integrations, and local proxy tools.

Overview

• Project type: Cloudflare Workers / MCP tool server
• Stack: TypeScript, Wrangler, Cloudflare Workers
• Purpose: expose MCP tools via a remote endpoint for AI clients

How to use

1. Install dependencies

npm install

2. Run locally

npm run dev

This starts the Cloudflare Workers development server and exposes the MCP endpoint locally.

3. Deploy to Cloudflare

npm run deploy

After deployment, your MCP endpoint will be available at the Worker URL under /mcp.

4. Connect with a client

Use the deployed URL in any MCP-compatible client.

Example URL format:

https://<your-worker-subdomain>.workers.dev/mcp

Project structure

• src/index.ts — main Worker entrypoint and MCP tool registration
• wrangler.jsonc — Cloudflare configuration
• package.json — scripts and dependencies
• README.md — this file

Available scripts

• npm run dev — start local development server
• npm run deploy — deploy the Worker to Cloudflare
• npm run cf-typegen — generate Wrangler types
• npm run type-check — run TypeScript type checking

Notes

• Use wrangler for Cloudflare configuration and deployment.
• Add MCP tools under src/index.ts to extend the server functionality.
• This setup is intended for development and experimentation with remote MCP tooling.