@phake/mcp

@phake/mcp is a TypeScript library for building Model Context Protocol (MCP) servers. It runs on Cloudflare Workers and Node.js, and gives you type-safe tool definitions, OAuth 2.1 authentication, and encrypted token storage out of the box.

Quick Start

Scaffold and deploy your first MCP server in minutes.

Define Tools

Create type-safe tools with Zod schemas and handler functions.

Authentication

Add OAuth, Bearer, API Key, or custom auth to your server.

API Reference

Full reference for createMCPServer, defineTool, and more.

Get started in 3 steps

Install the package

Add @phake/mcp to your project or scaffold a new one with a single command.

npm install @phake/mcp
# or scaffold a new project
bun create @phake/mcp my-mcp-app

Define your tools

Use defineTool to create typed, validated tools backed by Zod schemas.

import { z } from "zod";
import { defineTool } from "@phake/mcp";

const greetTool = defineTool({
  name: "greet",
  description: "Returns a greeting for the given name",
  inputSchema: z.object({ name: z.string() }),
  handler: async (args) => ({ message: `Hello, ${args.name}!` }),
});

Create and export your server

Wrap your tools in createMCPServer and export the result as your Worker default.

import { createMCPServer } from "@phake/mcp";

const server = createMCPServer({ tools: [greetTool] });
export default server;

Use the scaffold CLI to get a working project with your chosen template in seconds: bun create @phake/mcp my-app --template cloudflare-workers --install

Get Started

Core Concepts

Authentication

Guides

Configuration

Quick Start

Define Tools

Authentication

API Reference

Get started in 3 steps

Quick Start

Define Tools

Authentication

API Reference

​Get started in 3 steps

Get started in 3 steps