# @phake/mcp

> A TypeScript library for building MCP (Model Context Protocol) servers - works on both Cloudflare Workers and Node.js.

## Docs

- [createMCPServer](https://docs-mcp.phake.app/api/create-mcp-server.md): Factory function that creates a fully configured MCP server instance for Cloudflare Workers.
- [defineTool](https://docs-mcp.phake.app/api/define-tool.md): Type-safe factory for creating MCP tool definitions with input validation, structured output, and optional authentication.
- [Endpoints](https://docs-mcp.phake.app/api/endpoints.md): Complete reference for all HTTP endpoints exposed by an @phake/mcp server, including MCP transport and OAuth 2.1 routes.
- [Storage backends](https://docs-mcp.phake.app/api/storage-backends.md): Reference for all token and session storage backends available in @phake/mcp, including KV, memory, file, and SQLite options.
- [Tool context](https://docs-mcp.phake.app/api/tool-context.md): Reference for the ToolContext object passed to every tool handler, including authentication, session, cancellation, and Cloudflare bindings.
- [GitHub OAuth](https://docs-mcp.phake.app/authentication/github.md): Configure GitHub OAuth authentication for your MCP server.
- [Google OAuth](https://docs-mcp.phake.app/authentication/google.md): Configure Google OAuth authentication for your MCP server.
- [Comparison with Official SDK](https://docs-mcp.phake.app/comparison.md): Feature-by-feature comparison between @phake/mcp and the official MCP SDK, with guidance on which to choose.
- [Authentication](https://docs-mcp.phake.app/concepts/authentication.md): Protect your MCP server with one of five built-in authentication strategies.
- [Storage](https://docs-mcp.phake.app/concepts/storage.md): Token and session stores that persist OAuth state and MCP sessions across requests.
- [Tools](https://docs-mcp.phake.app/concepts/tools.md): Define typed functions that LLMs can call from your MCP server.
- [Auth strategies](https://docs-mcp.phake.app/configuration/auth-strategies.md): How to configure each of the five authentication strategies in @phake/mcp: oauth, bearer, api_key, custom, and none.
- [Environment variables](https://docs-mcp.phake.app/configuration/environment-variables.md): Complete reference for all environment variables used to configure your @phake/mcp server.
- [Client Setup](https://docs-mcp.phake.app/guides/client-configuration.md): Configure your MCP client to connect to a @phake/mcp server. Covers Claude Desktop, Claude Code, Cursor, VSCode, and Claude Web.
- [Cloudflare Workers](https://docs-mcp.phake.app/guides/cloudflare-workers.md): Deploy your MCP server to Cloudflare Workers with KV-backed token storage and AES-256-GCM encryption.
- [Node.js](https://docs-mcp.phake.app/guides/nodejs.md): Run your MCP server on Node.js using Hono and the @phake/mcp Node.js adapter.
- [OAuth Setup](https://docs-mcp.phake.app/guides/oauth-setup.md): Configure OAuth 2.1 for your MCP server. Your server acts as an authorization server that proxies authentication to an upstream provider such as Google.
- [Installation](https://docs-mcp.phake.app/installation.md): Requirements and installation instructions for @phake/mcp.
- [Introduction](https://docs-mcp.phake.app/introduction.md): An overview of @phake/mcp — a TypeScript library for building MCP servers on Cloudflare Workers and Node.js.
- [Quick start](https://docs-mcp.phake.app/quickstart.md): Scaffold a new MCP server in seconds, or follow the manual setup path to add @phake/mcp to an existing project.