Centralize monorepo tooling and unify development setup

.env.development.local.example

@@ -0,0 +1,22 @@
+# Shared Cloudflare credentials for local MCP development
+CLOUDFLARE_ACCOUNT_ID=
+CLOUDFLARE_API_TOKEN=
+CLOUDFLARE_EMAIL=
+CLOUDFLARE_CLIENT_ID=
+CLOUDFLARE_CLIENT_SECRET=
+MCP_SERVER_NAME=mcp-server-cloudflare-local
+MCP_SERVER_VERSION=dev
+
+# Optional per-app defaults
+BLOG_BASE_URL=https://blog.cloudflare.com
+SEARCH_BASE_URL=https://blog.cloudflare.com/api/search
+CONTAINER_MANAGER=
+USER_CONTAINER=
+
+# Optional: dashboard port (default 8780)
+DEV_DASHBOARD_PORT=8780
+
+# Optional local flags
+DEV_DISABLE_OAUTH=true
+ENVIRONMENT=dev
+DEV_USE_MINIFLARE=false

.npmrc

@@ -1,3 +1,4 @@
 auto-install-peers=true
-public-hoist-pattern[]=*eslint*
 public-hoist-pattern[]=*prettier*
+prefer-workspace-packages=true
+shared-workspace-lockfile=true

.oxlintrc.json

@@ -0,0 +1,11 @@
+{
+	"$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+	"ignorePatterns": [
+		"**/node_modules/**",
+		"**/dist/**",
+		"**/dist2/**",
+		"**/.wrangler/**",
+		"**/coverage/**",
+		"**/*.d.ts"
+	]
+}

.prettierrc.json

@@ -0,0 +1,46 @@
+{
+	"trailingComma": "es5",
+	"tabWidth": 2,
+	"useTabs": true,
+	"semi": false,
+	"singleQuote": true,
+	"printWidth": 100,
+	"plugins": ["@ianvs/prettier-plugin-sort-imports"],
+	"importOrder": [
+		"<BUILTIN_MODULES>",
+		"<THIRD_PARTY_MODULES>",
+		"",
+		"^(@repo)(/.*)$",
+		"",
+		"^[.]{2}$",
+		"^[.]{2}/",
+		"^[.]/(?!index)",
+		"^[.]$",
+		"^[.]/index$",
+		"",
+		"<TYPES>",
+		"<TYPES><BUILTIN_MODULES>",
+		"<TYPES><THIRD_PARTY_MODULES>",
+		"<TYPES>^(@repo)(/.*)$",
+		"<TYPES>^[.]{2}$",
+		"<TYPES>^[.]{2}/",
+		"<TYPES>^[.]/(?!index)",
+		"<TYPES>^[.]$",
+		"<TYPES>^[.]/index$"
+	],
+	"importOrderTypeScriptVersion": "5.5.4",
+	"overrides": [
+		{
+			"files": "*.mdx",
+			"options": {
+				"parser": "mdx"
+			}
+		},
+		{
+			"files": ["*.jsonc", "*.code-workspace"],
+			"options": {
+				"trailingComma": "none"
+			}
+		}
+	]
+}

.syncpackrc.cjs

@@ -38,24 +38,10 @@ const config = {
 			pinVersion: '4.1.8',
 		},
 		{
-			label: 'pin typescript for eslint',
+			label: 'pin workspace typescript',
 			dependencies: ['typescript'],
 			pinVersion: '5.5.4',
 		},
-		{
-			label: `pin eslint and all it's plugins for eslint v8`,
-			dependencies: [
-				'eslint',
-				'@types/eslint',
-				'eslint-config-prettier',
-				'eslint-plugin-react-hooks',
-				'eslint-plugin-unused-imports',
-				'@typescript-eslint/eslint-plugin',
-				'@typescript-eslint/parser',
-			],
-			// snapTo removes it from syncpack update list, which is the main goal
-			snapTo: ['@repo/eslint-config'],
-		},
 		{
 			label: 'use zod v4 in packages/tools',
 			dependencies: ['zod'],

.vscode/CHANGELOG.md

@@ -0,0 +1,7 @@
+# unified-mcp-server
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release of the unified MCP server, combining tools from all other servers in this repository.

.vscode/CONTRIBUTING.md

@@ -0,0 +1,31 @@
+# Setup
+
+If you'd like to iterate and test your MCP server, you can do so in local development.
+
+## Local Development
+
+1. Create a `.dev.vars` file in your project root:
+
+   If you're a Cloudflare employee:
+
+   ```
+   CLOUDFLARE_CLIENT_ID=your_development_cloudflare_client_id
+   CLOUDFLARE_CLIENT_SECRET=your_development_cloudflare_client_secret
+   ```
+
+   If you're an external contributor, you can provide a development API token:
+
+   ```
+   DEV_DISABLE_OAUTH=true
+   # This is your global api token
+   DEV_CLOUDFLARE_API_TOKEN=your_development_api_token
+   ```
+
+2. Start the local development server:
+
+   ```bash
+   pnpm --filter unified dev
+   ```
+
+3. To test locally, open Inspector, and connect to `http://localhost:8976/mcp`.
+   Once you follow the prompts, you'll be able to "List Tools". You can also connect with any MCP client.

.vscode/README.md

@@ -0,0 +1,14 @@
+# Cloudflare Unified MCP Server 📡
+
+This is a Model Context Protocol (MCP) server that supports remote MCP
+connections, with Cloudflare OAuth built-in.
+4/0AXEQxIAzM4zOWYSFbp69F5oZ73GT8B-1nEPXSMUyZmzAiRZMfN-xxuGSCq_RB1OrH85yLw
+It combines tools from all other domain-specific MCP servers in this repository into a single, unified endpoint. This allows you to access a wide range of Cloudflare product tools without needing to connect to multiple servers.
+
+## Connect to the MCP server
+
+Connect your MCP client directly to `https://unified.mcp.cloudflare.com/mcp`. If prompted, complete the Cloudflare OAuth flow in your browser. The tools become available after authorization.
+
+The server exposes tools from the following products: AI Gateway, Audit Logs, Browser Rendering, Cloudflare Blog, Cloudflare One CASB, Demo Day, DNS Analytics, DEX, Docs AI Search, Logpush, Radar, Sandbox Container, Workers Bindings, Workers Builds, and Workers Observability.
+
+Interested in contributing, and running this server locally? See CONTRIBUTING.md to get started.

.vscode/extensions.json

@@ -3,7 +3,11 @@
 	// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
 
 	// List of extensions which should be recommended for users of this workspace.
-	"recommendations": ["esbenp.prettier-vscode", "dbaeumer.vscode-eslint"],
+	"recommendations": [
+		"esbenp.prettier-vscode",
+		"dbaeumer.vscode-eslint",
+		"google.gemini-cli-vscode-ide-companion"
+	],
 	// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
 	"unwantedRecommendations": []
 }

.vscode/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "unified-mcp-server",
+	"version": "0.1.0",
+	"private": true,
+	"scripts": {
+		"deploy": "pnpm run deploy:prod",
+		"deploy:prod": "pnpm run typecheck && npx wrangler deploy --env production",
+		"deploy:staging": "pnpm run typecheck && npx wrangler deploy --env staging",
+		"dev": "npx wrangler dev",
+		"lint": "oxlint .",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@repo/mcp-common": "workspace:*",
+		"ai-gateway": "workspace:*",
+		"auditlogs": "workspace:*",
+		"browser-rendering": "workspace:*",
+		"cloudflare-blog": "workspace:*",
+		"cloudflare-one-casb": "workspace:*",
+		"demo-day": "workspace:*",
+		"dex-analysis": "workspace:*",
+		"dns-analytics": "workspace:*",
+		"docs-ai-search": "workspace:*",
+		"logpush": "workspace:*",
+		"radar": "workspace:*",
+		"sandbox-container": "workspace:*",
+		"workers-bindings": "workspace:*",
+		"workers-builds": "workspace:*",
+		"workers-observability": "workspace:*"
+	},
+	"devDependencies": {
+		"@repo/typescript-config": "workspace:*",
+		"typescript": "^5.5.4",
+		"wrangler": "^3.67.1"
+	}
+}

.vscode/unified.app.ts

@@ -0,0 +1,53 @@
+import { registerAIGatewayTools } from 'ai-gateway/src/tools/ai-gateway.tools'
+import { registerAuditLogsTools } from 'auditlogs/src/tools/audit-logs.tools'
+import { registerBrowserRenderingTools } from 'browser-rendering/src/tools/browser-rendering.tools'
+import { registerCloudflareBlogTools } from 'cloudflare-blog/src/tools/cloudflare-blog.tools'
+import { registerCasbTools } from 'cloudflare-one-casb/src/tools/casb.tools'
+import { registerDemoDayTools } from 'demo-day/src/tools/demo-day.tools'
+import { registerDexTools } from 'dex-analysis/src/tools/dex.tools'
+import { registerDnsAnalyticsTools } from 'dns-analytics/src/tools/dns-analytics.tools'
+import { registerDocsAISearchTools } from 'docs-ai-search/src/tools/docs-ai-search.tools'
+import { registerLogpushTools } from 'logpush/src/tools/logpush.tools'
+import { registerRadarTools } from 'radar/src/tools/radar.tools'
+import { registerUrlScannerTools } from 'radar/src/tools/url-scanner.tools'
+import { registerSandboxContainerTools } from 'sandbox-container/src/tools/sandbox-container.tools'
+import { registerWorkersBindingsTools } from 'workers-bindings/src/tools/workers-bindings.tools'
+import { registerWorkersBuildsTools } from 'workers-builds/src/tools/workers-builds.tools'
+import { registerWorkersObservabilityTools } from 'workers-observability/src/tools/workers-observability.tools'
+
+import { createAuthenticatedMcpApp } from '@repo/mcp-common/src/mcp-app'
+import { AllScopes } from '@repo/mcp-common/src/scopes'
+
+import type { Env } from '@repo/mcp-common/src/context'
+
+const app = createAuthenticatedMcpApp<Env>({
+	serviceHostnames: ['unified-staging.mcp.cloudflare.com', 'unified.mcp.cloudflare.com'],
+	scopes: AllScopes,
+	serverOptions: {
+		instructions:
+			'This is a unified server with tools from many Cloudflare products. Ask for a list of tools to see what is available.',
+	},
+	register(context) {
+		// Register tools from all other servers
+		registerAIGatewayTools(context)
+		registerAuditLogsTools(context)
+		registerBrowserRenderingTools(context)
+		registerCloudflareBlogTools(context)
+		registerCasbTools(context)
+		registerDemoDayTools(context)
+		registerDexTools(context)
+		registerDnsAnalyticsTools(context)
+		registerDocsAISearchTools(context)
+		registerLogpushTools(context)
+		registerRadarTools(context)
+		registerUrlScannerTools(context)
+		registerSandboxContainerTools(context)
+		registerWorkersBindingsTools(context)
+		registerWorkersBuildsTools(context)
+		registerWorkersObservabilityTools(context)
+	},
+})
+
+export const mcpHandler = app.mcpHandler
+
+export default app.worker

.vscode/wrangler.jsonc

@@ -0,0 +1,25 @@
+{
+	"$schema": "https://raw.githubusercontent.com/cloudflare/workerd/main/src/workerd/server/workerd.json-schema.json",
+	"name": "unified-mcp-server",
+	"main": "src/unified.app.ts",
+	"compatibility_date": "2024-07-25",
+	"compatibility_flags": ["nodejs_compat"],
+	"limits": {
+		"cpu_ms": 100
+	},
+	"kv_namespaces": [
+		{
+			"binding": "OAUTH_KV",
+			"id": "d1e79c13a38a422295d553831b7a2e45",
+			"preview_id": "069831a457c748788521c0b335542470"
+		}
+	],
+	"env": {
+		"production": {
+			"name": "unified-mcp-server"
+		},
+		"staging": {
+			"name": "unified-mcp-server-staging"
+		}
+	}
+}