/** * @license * Copyright 2025 Google LLC * SPDX-License-Identifier: Apache-2.0 */ import * as vscode from 'vscode'; import { IdeContextNotificationSchema } from '@google/gemini-cli-core'; import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js'; import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'; import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'; import express, { type Request, type Response } from 'express'; import { randomUUID } from 'node:crypto'; import { type Server as HTTPServer } from 'node:http'; import * as path from 'node:path'; import * as fs from 'node:fs/promises'; import * as os from 'node:os'; import { z } from 'zod'; import { DiffManager } from './diff-manager.js'; import { OpenFilesManager } from './open-files-manager.js'; const MCP_SESSION_ID_HEADER = 'mcp-session-id'; const IDE_SERVER_PORT_ENV_VAR = 'GEMINI_CLI_IDE_SERVER_PORT'; const IDE_WORKSPACE_PATH_ENV_VAR = 'GEMINI_CLI_IDE_WORKSPACE_PATH'; function writePortAndWorkspace( context: vscode.ExtensionContext, port: number, portFile: string, log: (message: string) => void, ): Promise { const workspaceFolders = vscode.workspace.workspaceFolders; const workspacePath = workspaceFolders && workspaceFolders.length > 0 ? workspaceFolders.map((folder) => folder.uri.fsPath).join(path.delimiter) : ''; context.environmentVariableCollection.replace( IDE_SERVER_PORT_ENV_VAR, port.toString(), ); context.environmentVariableCollection.replace( IDE_WORKSPACE_PATH_ENV_VAR, workspacePath, ); log(`Writing port file to: ${portFile}`); return fs .writeFile(portFile, JSON.stringify({ port, workspacePath })) .catch((err) => { const message = err instanceof Error ? err.message : String(err); log(`Failed to write port to file: ${message}`); }); } function sendIdeContextUpdateNotification( transport: StreamableHTTPServerTransport, log: (message: string) => void, openFilesManager: OpenFilesManager, ) { const ideContext = openFilesManager.state; const notification = IdeContextNotificationSchema.parse({ jsonrpc: '2.0', method: 'ide/contextUpdate', params: ideContext, }); log( `Sending IDE context update notification: ${JSON.stringify( notification, null, 2, )}`, ); transport.send(notification); } export class IDEServer { private server: HTTPServer | undefined; private context: vscode.ExtensionContext | undefined; private log: (message: string) => void; private portFile: string; private port: number | undefined; diffManager: DiffManager; constructor(log: (message: string) => void, diffManager: DiffManager) { this.log = log; this.diffManager = diffManager; this.portFile = path.join( os.tmpdir(), `gemini-ide-server-${process.ppid}.json`, ); } start(context: vscode.ExtensionContext): Promise { return new Promise((resolve) => { this.context = context; const sessionsWithInitialNotification = new Set(); const transports: { [sessionId: string]: StreamableHTTPServerTransport } = {}; const app = express(); app.use(express.json()); const mcpServer = createMcpServer(this.diffManager); const openFilesManager = new OpenFilesManager(context); const onDidChangeSubscription = openFilesManager.onDidChange(() => { for (const transport of Object.values(transports)) { sendIdeContextUpdateNotification( transport, this.log.bind(this), openFilesManager, ); } }); context.subscriptions.push(onDidChangeSubscription); const onDidChangeDiffSubscription = this.diffManager.onDidChange( (notification) => { for (const transport of Object.values(transports)) { transport.send(notification); } }, ); context.subscriptions.push(onDidChangeDiffSubscription); app.post('/mcp', async (req: Request, res: Response) => { const sessionId = req.headers[MCP_SESSION_ID_HEADER] as | string | undefined; let transport: StreamableHTTPServerTransport; if (sessionId && transports[sessionId]) { transport = transports[sessionId]; } else if (!sessionId && isInitializeRequest(req.body)) { transport = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (newSessionId) => { this.log(`New session initialized: ${newSessionId}`); transports[newSessionId] = transport; }, }); const keepAlive = setInterval(() => { try { transport.send({ jsonrpc: '2.0', method: 'ping' }); } catch (e) { this.log( 'Failed to send keep-alive ping, cleaning up interval.' + e, ); clearInterval(keepAlive); } }, 60000); // 60 sec transport.onclose = () => { clearInterval(keepAlive); if (transport.sessionId) { this.log(`Session closed: ${transport.sessionId}`); sessionsWithInitialNotification.delete(transport.sessionId); delete transports[transport.sessionId]; } }; mcpServer.connect(transport); } else { this.log( 'Bad Request: No valid session ID provided for non-initialize request.', ); res.status(400).json({ jsonrpc: '2.0', error: { code: -32000, message: 'Bad Request: No valid session ID provided for non-initialize request.', }, id: null, }); return; } try { await transport.handleRequest(req, res, req.body); } catch (error) { const errorMessage = error instanceof Error ? error.message : 'Unknown error'; this.log(`Error handling MCP request: ${errorMessage}`); if (!res.headersSent) { res.status(500).json({ jsonrpc: '2.0' as const, error: { code: -32603, message: 'Internal server error', }, id: null, }); } } }); const handleSessionRequest = async (req: Request, res: Response) => { const sessionId = req.headers[MCP_SESSION_ID_HEADER] as | string | undefined; if (!sessionId || !transports[sessionId]) { this.log('Invalid or missing session ID'); res.status(400).send('Invalid or missing session ID'); return; } const transport = transports[sessionId]; try { await transport.handleRequest(req, res); } catch (error) { const errorMessage = error instanceof Error ? error.message : 'Unknown error'; this.log(`Error handling session request: ${errorMessage}`); if (!res.headersSent) { res.status(400).send('Bad Request'); } } if (!sessionsWithInitialNotification.has(sessionId)) { sendIdeContextUpdateNotification( transport, this.log.bind(this), openFilesManager, ); sessionsWithInitialNotification.add(sessionId); } }; app.get('/mcp', handleSessionRequest); this.server = app.listen(0, async () => { const address = (this.server as HTTPServer).address(); if (address && typeof address !== 'string') { this.port = address.port; this.log(`IDE server listening on port ${this.port}`); await writePortAndWorkspace( context, this.port, this.portFile, this.log, ); } resolve(); }); }); } async updateWorkspacePath(): Promise { if (this.context && this.port) { await writePortAndWorkspace( this.context, this.port, this.portFile, this.log, ); } } async stop(): Promise { if (this.server) { await new Promise((resolve, reject) => { this.server!.close((err?: Error) => { if (err) { this.log(`Error shutting down IDE server: ${err.message}`); return reject(err); } this.log(`IDE server shut down`); resolve(); }); }); this.server = undefined; } if (this.context) { this.context.environmentVariableCollection.clear(); } try { await fs.unlink(this.portFile); } catch (_err) { // Ignore errors if the file doesn't exist. } } } const createMcpServer = (diffManager: DiffManager) => { const server = new McpServer( { name: 'gemini-cli-companion-mcp-server', version: '1.0.0', }, { capabilities: { logging: {} } }, ); server.registerTool( 'openDiff', { description: '(IDE Tool) Open a diff view to create or modify a file. Returns a notification once the diff has been accepted or rejcted.', inputSchema: z.object({ filePath: z.string(), // TODO(chrstn): determine if this should be required or not. newContent: z.string().optional(), }).shape, }, async ({ filePath, newContent, }: { filePath: string; newContent?: string; }) => { await diffManager.showDiff(filePath, newContent ?? ''); return { content: [ { type: 'text', text: `Showing diff for ${filePath}`, }, ], }; }, ); server.registerTool( 'closeDiff', { description: '(IDE Tool) Close an open diff view for a specific file.', inputSchema: z.object({ filePath: z.string(), }).shape, }, async ({ filePath }: { filePath: string }) => { const content = await diffManager.closeDiff(filePath); const response = { content: content ?? undefined }; return { content: [ { type: 'text', text: JSON.stringify(response), }, ], }; }, ); return server; };