|
| 1 | +import OAuthProvider from '@cloudflare/workers-oauth-provider' |
| 2 | +import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js' |
| 3 | +import { createMcpHandler } from 'agents/mcp' |
| 4 | + |
| 5 | +import { AccountManager } from '@repo/mcp-common/src/account-manager' |
| 6 | +import { isApiTokenRequest } from '@repo/mcp-common/src/api-token-mode' |
| 7 | +import { |
| 8 | + createAuthHandlers, |
| 9 | + getUserAndAccounts, |
| 10 | + handleTokenExchangeCallback, |
| 11 | +} from '@repo/mcp-common/src/cloudflare-oauth-handler' |
| 12 | +import { getEnv } from '@repo/mcp-common/src/env' |
| 13 | +import { RequiredScopes } from '@repo/mcp-common/src/scopes' |
| 14 | +import { MetricsTracker } from '@repo/mcp-observability' |
| 15 | + |
| 16 | +import { registerWebSearchTools } from './tools/websearch.tools' |
| 17 | +import { BASE_INSTRUCTIONS } from './websearch.context' |
| 18 | + |
| 19 | +import type { AuthProps } from '@repo/mcp-common/src/cloudflare-oauth-handler' |
| 20 | +import type { Env } from './websearch.context' |
| 21 | + |
| 22 | +const env = getEnv<Env>() |
| 23 | + |
| 24 | +const metrics = new MetricsTracker(env.MCP_METRICS, { |
| 25 | + name: env.MCP_SERVER_NAME, |
| 26 | + version: env.MCP_SERVER_VERSION, |
| 27 | +}) |
| 28 | + |
| 29 | +const WebSearchScopes = { |
| 30 | + ...RequiredScopes, |
| 31 | + 'account:read': 'See your account info such as account details, analytics, and memberships.', |
| 32 | + 'websearch.run': 'Grants access to run Cloudflare Web Search queries.', |
| 33 | +} as const |
| 34 | + |
| 35 | +// Stateless: createMcpHandler needs a fresh server per request. AccountManager + buildAccountTool |
| 36 | +// give the same account resolution (auth-pinned → cf-account-id header → account_id arg) the |
| 37 | +// McpAgent servers get from CloudflareMCPServer.accountTool(). |
| 38 | +// TODO(RAG-1300): tool-call metrics are not yet tracked for the stateless server. |
| 39 | +function createServer(env: Env, props: AuthProps): McpServer { |
| 40 | + const accountManager = new AccountManager(props) |
| 41 | + const server = new McpServer( |
| 42 | + { name: env.MCP_SERVER_NAME, version: env.MCP_SERVER_VERSION }, |
| 43 | + { instructions: `${BASE_INSTRUCTIONS}${accountManager.instructionsSuffix()}` } |
| 44 | + ) |
| 45 | + registerWebSearchTools(server, accountManager, props.accessToken) |
| 46 | + return server |
| 47 | +} |
| 48 | + |
| 49 | +// Stateless streamable-HTTP handler. Reads the AuthProps set by the OAuthProvider (OAuth mode) |
| 50 | +// or by the API-token branch below, then builds a fresh server for the request. |
| 51 | +function mcpFetch(req: Request, env: Env, ctx: ExecutionContext): Promise<Response> { |
| 52 | + const { props } = ctx as { props: AuthProps } |
| 53 | + const handler = createMcpHandler(createServer(env, props), { route: '/mcp' }) |
| 54 | + return handler(req, env, ctx) |
| 55 | +} |
| 56 | + |
| 57 | +// Resolve a raw Cloudflare API token into the same AuthProps shape the OAuth flow produces, so |
| 58 | +// AccountManager can pin/validate the account (mirrors mcp-common's handleApiTokenMode). |
| 59 | +async function buildApiTokenProps(req: Request, env: Env): Promise<AuthProps> { |
| 60 | + let devModeHeaders: HeadersInit | undefined |
| 61 | + let token: string |
| 62 | + if (env.DEV_CLOUDFLARE_API_TOKEN && env.DEV_DISABLE_OAUTH === 'true') { |
| 63 | + devModeHeaders = { Authorization: `Bearer ${env.DEV_CLOUDFLARE_API_TOKEN}` } |
| 64 | + token = env.DEV_CLOUDFLARE_API_TOKEN |
| 65 | + } else { |
| 66 | + const [, bearer] = (req.headers.get('Authorization') ?? '').split(' ') |
| 67 | + token = bearer ?? '' |
| 68 | + } |
| 69 | + |
| 70 | + const { user, accounts } = await getUserAndAccounts(token, devModeHeaders) |
| 71 | + if (user === null) { |
| 72 | + return { type: 'account_token', accessToken: token, account: accounts[0] } |
| 73 | + } |
| 74 | + return { type: 'user_token', accessToken: token, user, accounts } |
| 75 | +} |
| 76 | + |
| 77 | +export default { |
| 78 | + fetch: async (req: Request, env: Env, ctx: ExecutionContext): Promise<Response> => { |
| 79 | + // Raw Cloudflare API token bearer → skip OAuth, use it directly. |
| 80 | + // OAuth-issued tokens are excluded by isApiTokenRequest and fall through. |
| 81 | + if (await isApiTokenRequest(req, env)) { |
| 82 | + // `ExecutionContext.props` is typed readonly, but the handler reads the props we |
| 83 | + // set here before the request is served, so assign through a typed mutable view. |
| 84 | + const ctxWithProps = ctx as { props: AuthProps } |
| 85 | + ctxWithProps.props = await buildApiTokenProps(req, env) |
| 86 | + return mcpFetch(req, env, ctx) |
| 87 | + } |
| 88 | + |
| 89 | + // OAuth mode: advertises the OAuth endpoints and decrypts OAuth-issued |
| 90 | + // tokens into ctx.props before delegating to the MCP handler. |
| 91 | + return new OAuthProvider({ |
| 92 | + apiHandlers: { |
| 93 | + '/mcp': { fetch: mcpFetch }, |
| 94 | + }, |
| 95 | + defaultHandler: createAuthHandlers({ scopes: WebSearchScopes, metrics }), |
| 96 | + authorizeEndpoint: '/oauth/authorize', |
| 97 | + tokenEndpoint: '/token', |
| 98 | + tokenExchangeCallback: (options) => |
| 99 | + handleTokenExchangeCallback( |
| 100 | + options, |
| 101 | + env.CLOUDFLARE_CLIENT_ID, |
| 102 | + env.CLOUDFLARE_CLIENT_SECRET |
| 103 | + ), |
| 104 | + // Cloudflare access token TTL |
| 105 | + accessTokenTTL: 3600, |
| 106 | + refreshTokenTTL: 2592000, // 30 days |
| 107 | + clientRegistrationEndpoint: '/register', |
| 108 | + }).fetch(req, env, ctx) |
| 109 | + }, |
| 110 | +} |
0 commit comments