# 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

```bash
npm install
```

### 2. Run locally

```bash
npm run dev
```

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

### 3. Deploy to Cloudflare

```bash
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:

```text
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.