drio
Open app

Headless Code Editor MCP Server

Source

Headless Editor MCP Server for intelligent code editing

Catalog onlyCatalog onlySTDIO

Overview

Headless Code Editor MCP Server is a robust, language-agnostic code editor that utilizes the Language Server Protocol (LSP) and Model Context Protocol (MCP) for enhanced code intelligence and AI-assisted code manipulation.

To use the server, install dependencies, build the project, and start the server with the desired workspace directory. Additionally, you can create a new editing session, apply code edits, and validate the current code state through MCP tools available via its API.

  • Language Server Protocol support for coding languages - Secure file system operations with strict access controls - State management for session-based editing - In-depth analysis for TypeScript/JavaScript code - React component detection and manipulation - Comprehensive logging and error tracking
  1. AI-assisted code editing for TypeScript/JavaScript projects.
  2. Automating React component manipulation.
  3. Enhancing security during code transactions with strict file access controls.

Add to your AI client

Use these steps to connect Headless Code Editor MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "headless-editor-mcp-oakenai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-headless-editor-mcp-oakenai"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "headless-editor-mcp-oakenai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-headless-editor-mcp-oakenai"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "headless-editor-mcp-oakenai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-headless-editor-mcp-oakenai"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "headless-editor-mcp-oakenai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-headless-editor-mcp-oakenai"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "headless-editor-mcp-oakenai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-headless-editor-mcp-oakenai"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "headless-editor-mcp-oakenai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-headless-editor-mcp-oakenai"
      ]
    }
  }
}

FAQ

What languages does the editor support currently?

The server currently supports TypeScript and JavaScript with future expansions planned for Python and Java.

Can I use it for team development?

Yes! The server is designed for session-based editing, which can facilitate collaboration.

Is there any documentation available for new users?

Yes, the project includes detailed documentation covering architecture, design principles, and integration instructions.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":406,"uuid":"f83d15c6-a63a-45f9-98df-05d4e4c4434d","name":"headless-editor-mcp","title":"Headless Code Editor MCP Server","description":"Headless Editor MCP Server for intelligent code editing","avatar_url":"https://avatars.githubusercontent.com/u/110275537?v=4","created_at":"2024-12-15T06:46:33.451Z","updated_at":"2024-12-16T06:52:43.152Z","status":"created","author_name":"oakenai","author_avatar_url":"https://avatars.githubusercontent.com/u/110275537?v=4","tags":"headless-editor,code-editor,ai-code-assistant","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/oakenai/headless-editor-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools