Headless Code Editor MCP Server

无头代码编辑器 MCP 服务

一款稳健、语言无关的无头代码编辑器，利用语言服务器协议（LSP）实现代码智能，并通过模型上下文协议（MCP）实现 AI 辅助代码操作。

功能

• 集成 LSP，提供语言智能功能
• 采用严格访问控制的安全文件系统操作
• 基于会话的编辑与状态管理
• 支持 TypeScript/JavaScript，并提供深入分析
• 检测和操作 React 组件
• 保留格式的编辑操作
• 全面的日志记录和错误跟踪

安装

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

用法

启动服务

# Start with 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 工具

1. start_session：创建新的编辑会话
2. edit_code：对代码应用编辑
3. validate_code：验证当前代码状态
4. close_session：清理并关闭会话

集成示例

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

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

await client.connect(transport);

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

架构

• LSP 管理器：协调语言服务器的生命周期和通信
• 文档管理器：处理文档状态和同步
• 会话管理器：管理编辑会话和状态
• 编辑操作管理器：处理并验证代码编辑
• 文件系统管理器：提供安全的文件系统访问

安全功能

• 路径验证和规范化
• 通过允许的目录进行访问控制
• 输入清理
• 文件系统操作边界
• 符号链接安全检查

未完成任务

语言支持

• 集成 Python 语言服务器
• 集成 Java 语言服务器
• 支持其他语言服务器

框架支持

• 组件状态分析
• 跟踪 Hook 依赖项
• 自动管理导入
• 基于类型的重构

编辑操作

• 多文件编辑操作
• 复杂重构操作
• 工作区范围的更改
• 冲突解决系统

性能

• 操作批处理
• 增量更新优化
• 内存使用优化
• 改进大型文件处理

测试

• 端到端测试套件
• 性能基准测试
• 负载测试
• 跨平台测试

文档

• API 文档
• 集成指南
• 部署指南
• 故障排除指南

基础设施

• 远程服务支持
• 配置系统
• 插件架构
• 工作区索引

监控

• 性能指标
• 操作分析
• 健康状况监控
• 资源使用跟踪

贡献

1. Fork 此仓库
2. 创建功能分支
3. 为新功能添加测试
4. 确保所有测试通过
5. 提交拉取请求

文档

架构与设计

• 核心架构：基础架构和系统设计
• LSP 智能编辑器架构：语言服务器协议集成详情
• 框架集成指南：特定框架的支持和集成模式
• 语言服务器集成：语言服务器的实现和配置
• MVP 实施计划：开发路线图和实施阶段

我们的文档涵盖：

• 系统架构和设计原则
• 组件交互和依赖关系
• 框架集成模式
• 语言服务器规范
• 实施指南和最佳实践
• 安全注意事项
• 性能优化策略

如需其他文档，请参阅“未完成任务”部分。

许可证

MIT

开发状态

目前处于 Alpha 阶段（v0.0.10），提供基础的 TypeScript/JavaScript 支持和 React 组件分析。计划中的功能请参阅“未完成任务”部分。