Edit-MCP

Instructions

Implementation Reference

• src/index.ts:306-329 (registration)

  Registration of the interactive_edit_session tool, including input schema, description, and annotations.
  mcpServer.registerTool({ name: 'interactive_edit_session', description: 'Start an interactive editing session for complex edits', inputSchema: { type: 'object', properties: { files: { type: 'array', description: 'List of files to edit' }, instructions: { type: 'string', description: 'Instructions for the editing session' } }, required: ['files'] }, annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false } });
• src/index.ts:309-321 (schema)

  Input schema definition for the interactive_edit_session tool.
  inputSchema: { type: 'object', properties: { files: { type: 'array', description: 'List of files to edit' }, instructions: { type: 'string', description: 'Instructions for the editing session' } }, required: ['files']
• src/router/operation-router.ts:438-445 (handler)

  Handler logic in executeWithEdit: creates edit session for the files and returns sessionId without closing it.
  const sessionId = await this.editInstanceManager.createEditSession(operation.affectedFiles); try { switch (operation.type) { case 'interactive_edit_session': // Return the session ID for the client to use return { sessionId };
• src/edit-instance/edit-instance-manager.ts:272-282 (helper)

  Core helper function createEditSession that spawns an EditInstance process, opens the specified files, and returns the session ID for interactive use.
  public async createEditSession(files: string[]): Promise<string> { const sessionId = uuidv4(); const instance = await this.createInstance(sessionId); // Open all files for (const file of files) { await instance.openFile(file); } return sessionId; }
• src/router/operation-router.ts:492-494 (helper)

  Ensures the session remains open for interactive_edit_session by skipping closeEditSession.
  if (operation.type !== 'interactive_edit_session') { await this.editInstanceManager.closeEditSession(sessionId).catch(console.error); }