Skip to content

getting-started.md

Latest commit

 

History

History
134 lines (87 loc) · 2.75 KB

getting-started.md

File metadata and controls

134 lines (87 loc) · 2.75 KB

🛠️ Getting Started

Welcome! In this section, you'll set up your local environment and prepare to build your own MCP server using Cloudflare Workers.

📋 Prerequisites

Before we begin, make sure you have the following:

✅ Required

  • Node.js v18+ – Download
  • Cloudflare Account – Sign up
  • Code Editor – VS Code recommended
  • Terminal / Command Line access

🧰 Recommended

⚙️ Environment Setup

1️⃣ Check Node.js & npm

node --version
npm --version

Ensure you see version 18 or higher.

2️⃣ Install Wrangler CLI

Wrangler is Cloudflare’s CLI tool for building and deploying Workers.

npm install -g wrangler
wrangler --version

3️⃣ Login to Cloudflare

wrangler login

This will open a browser window for authentication. Complete the login to proceed.

4️⃣ Clone the Workshop Repo

git clone https://github.com/lauragift21/mcp-server-workshop.git
cd mcp-server-workshop

🧪 Project Setup

1️⃣ Choose a Use Case

Navigate into one of the use case folders:

cd use-cases/travel-planner
# or
cd use-cases/restaurant-reservation
# or
cd use-cases/meeting-summary

2️⃣ Install Dependencies

npm install

3️⃣ Review Project Structure

use-cases/<use-case-name>
├── package.json         # Project dependencies and scripts
├── wrangler.toml        # Cloudflare Worker configuration
├── tsconfig.json        # TypeScript configuration
├── src/
│   ├── index.ts         # Cloudflare Worker entry point
│   ├── server.ts        # MCP logic implementation
│   ├── tools/           # Individual tools
│   ├── resources/       # Resource handlers
│   └── types.ts         # Type declarations
└── README.md            # Use case guide

🔄 Local Development

Start Development Server

npm run dev

This starts the Worker at: http://localhost:8787

🎯 Next Steps

Once your environment is set up and you can run the test client successfully, you're ready to start building!

What's Next?

  • Understand Your Use Case: Read the README in your chosen use case directory
  • Implement Tools: Add the specific tools your use case needs
  • Deploy Your MCP Server: Deploy your MCP server to Cloudflare Workers

Environment ready? Let's start building your MCP server!

👉 Continue to Building an MCP →