Headless Editor MCP

🚀 无头代码编辑器 MCP 服务器

无头代码编辑器 MCP 服务器是一个强大且与语言无关的工具，它借助语言服务协议（LSP）实现代码智能，并通过模型上下文协议（MCP）达成 AI 辅助代码操作，为开发者提供高效、智能的代码编辑体验。

🚀 快速开始

无头代码编辑器 MCP 服务器能够为代码编辑提供智能支持和 AI 辅助。按照以下步骤进行安装和启动：

✨ 主要特性

• LSP 集成：支持语言智能，提升代码编辑效率。
• 安全文件系统操作：带有严格访问控制，保障操作安全。
• 会话式编辑与状态管理：方便开发者管理编辑状态。
• TypeScript/JavaScript 深度分析：专业支持这两种语言的开发。
• React 组件检测与操作：助力 React 项目开发。
• 保持格式的编辑操作：确保代码格式规范。
• 全面的日志记录和错误跟踪：便于问题排查。

📦 安装指南

# 安装依赖项
npm install

# 构建项目
npm run build

# 运行测试
npm test

💻 使用示例

基础用法

启动服务器

# 使用允许目录启动
node build/index.js /path/to/workspace

# 使用多个允许目录启动
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: {} }
);

// 连接到服务器
const transport = new StdioClientTransport({
  command: "node",
  args: ["./build/index.js", "/workspace"]
});

await client.connect(transport);

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

📚 详细文档

架构

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

安全特性

• 路径验证和规范化
• 通过允许目录实现访问控制
• 输入 sanitization（净化）
• 文件系统操作边界
• 链接安全检查

未完成的任务

语言支持

• [ ] Python 语言服务集成
• [ ] Java 语言服务集成
• [ ] 支持更多语言服务

框架支持

• [ ] 组件状态分析
• [ ] Hook 依赖跟踪
• [ ] 自动导入管理
• [ ] 类型感知重构

编辑操作

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

性能优化

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

测试

• [ ] 端到端测试套件
• [ ] 性能基准测试
• [ ] 加载测试
• [ ] 跨平台测试

文档

• [ ] API 文档
• [ ] 集成指南
• [ ] 文档说明
• [ ] LICENSE

开发状态

项目目前处于开发阶段，未来会持续更新和优化功能。

🔧 技术细节

本项目采用模块化架构，各个管理器负责不同的功能模块，通过合理的分工和协作，实现了代码编辑的各项功能。同时，利用 LSP 和 MCP 协议，与语言服务和 AI 进行交互，为开发者提供智能辅助。

📄 许可证

文档中未提及许可证相关信息。

贡献指南

欢迎社区贡献！请参考CONTRIBUTING.md了解如何参与。