patpil-cloudflare-mcp/mcp-typescript-docs

MCP TypeScript SDK Documentation AI Search

Semantic search over Model Context Protocol (MCP) TypeScript SDK documentation using Cloudflare AutoRAG (AI Search).

What is This?

This MCP server provides intelligent search over MCP TypeScript SDK documentation from GitHub:

• Semantic Search - Natural language queries over MCP SDK docs
• AI-Generated Answers - LLM responses grounded in documentation
• Dual Authentication - OAuth 2.1 and API key support

AI Search Instance: map-docs Domain: tsmcpdocs.wtyczki.ai

Use Cases:

• Learn MCP SDK architecture and core concepts
• Get TypeScript code examples for building MCP servers
• Understand tool definitions, resource handlers, and prompt patterns
• Troubleshoot MCP implementation issues

Available Tools

Production URLs

Features

• AutoRAG (AI Search) Ready - Pre-configured Workers AI binding
• Dual Transport Support - Both SSE (legacy) and Streamable HTTP
• ChatGPT Compatible - Works with ChatGPT via /mcp endpoint
• Claude Desktop Compatible - Works via /sse endpoint
• Dual Authentication - OAuth 2.1 and API key support
• WorkOS Magic Auth - Email + 6-digit code authentication

Testing

Pre-Deployment:

npx tsc --noEmit  # Must pass with zero errors

Post-Deployment (Cloudflare Workers AI Playground):

1. Navigate to https://playground.ai.cloudflare.com/
2. Set model to @cf/meta/llama-3.3-70b-instruct-fp8-fast
3. Add MCP server: https://tsmcpdocs.wtyczki.ai/sse
4. Complete OAuth flow
5. Test search_mcp_docs tool with query: "How do I define tools in an MCP server?"

Project Structure

tsmcpdocs/
├── src/
│   ├── index.ts              # Entry point (dual transport)
│   ├── server.ts             # McpTypescriptDocsMCP with tools
│   ├── api-key-handler.ts    # API key authentication path
│   ├── authkit-handler.ts    # WorkOS OAuth handler
│   ├── types.ts              # Type definitions
│   ├── props.ts              # Auth context
│   ├── tokenUtils.ts         # Token management
│   ├── tokenConsumption.ts   # Token consumption logic
│   ├── apiKeys.ts            # API key validation
│   └── api-client.ts         # API client template
├── wrangler.jsonc            # Cloudflare config
├── package.json              # Dependencies
└── README.md                 # This file

Configuration

GitHub Integration

This repository uses Cloudflare Workers Builds for automatic deployments. Every push to main triggers an automatic deployment to tsmcpdocs.wtyczki.ai.