Headless Editor MCP

🚀 Headless Code Editor MCP Server

A powerful, language-agnostic headless code editor that leverages the Language Server Protocol (LSP) for code intelligence and the Model Context Protocol (MCP) for AI-assisted code operations.

🚀 Quick Start

This headless code editor combines LSP for language intelligence and MCP for AI - assisted operations. It offers a range of features and secure file system operations.

✨ Features

• LSP integration for language intelligence
• Secure file system operations with strict access control
• Conversational editing and state management
• Language support for in - depth analysis of TypeScript/JavaScript
• React component detection and manipulation
• Format - preserving editing operations
• Comprehensive logging and error tracking

📦 Installation

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

💻 Usage Examples

Starting the Server

# Start with an allowed directory
node build/index.js /path/to/workspace

# Start with multiple allowed directories
node build/index.js /path/to/workspace1 /path/to/workspace2

MCP Tools

1. start_session: Create a new editing session
2. edit_code: Apply code modifications
3. validate_code: Validate the current code state
4. close_session: Clean up and close the session

Example Integration

const client = new Client(
  { name: "example-client", version: "1.0.0" },
  { capabilities: {} }
);

// Connect to the server
const transport = new StdioClientTransport({
  command: "node",
  args: ["./build/index.js", "/workspace"]
});

await client.connect(transport);

// Start a session
const result = await client.request({
  method: "tools/call",
  params: {
    name: "start_session",
    arguments: {
      filePath: "/workspace/example.ts",
      languageId: "typescript"
    }
  }
});

🔧 Technical Details

Architecture

• LSP Manager: Coordinates the lifecycle and communication of language services
• Document Manager: Handles document state and synchronization
• Session Manager: Manages editing sessions and states
• Edit Operation Manager: Processes and validates code modifications
• File System Manager: Provides secure file system access

Security Features

• Path validation and normalization
• Access control through allowed directories
• Input sanitization
• File system operation boundaries
• Link security checks

🚧 Incomplete Tasks

Language Support

• [ ] Python language service integration
• [ ] Java language service integration
• [ ] Support for more language services

Framework Support

• [ ] Component state analysis
• [ ] Hook dependency tracking
• [ ] Automatic import management
• [ ] Type - aware refactoring

Edit Operations

• [ ] Multi - file edit operations
• [ ] Complex refactoring operations
• [ ] Workspace - wide modifications
• [ ] Conflict resolution system

Performance Optimization

• [ ] Operation batch processing
• [ ] Incremental update optimization
• [ ] Memory usage optimization
• [ ] Improvements for handling large files

Testing

• [ ] End - to - end test suite
• [ ] Performance benchmark testing
• [ ] Load testing
• [ ] Cross - platform testing

Documentation

• [ ] API documentation
• [ ] Integration guide
• [ ] Documentation instructions
• [ ] LICENSE

Development Status

The project is currently in the development phase, and features will be continuously updated and optimized in the future.

🤝 Contribution Guidelines

Community contributions are welcome! Please refer to CONTRIBUTING.md to learn how to get involved.