Headless Editor MCP

🚀 無頭代碼編輯器 MCP 服務器

無頭代碼編輯器 MCP 服務器是一個強大且與語言無關的工具。它藉助語言服務協議（LSP）實現代碼智能，通過模型上下文協議（MCP）達成 AI 輔助代碼操作，能有效解決代碼編輯中的智能支持和 AI 輔助問題，為開發者提供更高效的編碼體驗。

🚀 快速開始

無頭代碼編輯器 MCP 服務器可助力開發者實現智能代碼編輯和 AI 輔助操作。以下為你介紹其啟動方式：

# 使用允許目錄啟動
node build/index.js /path/to/workspace

# 使用多個允許目錄啟動
node build/index.js /path/to/workspace1 /path/to/workspace2

✨ 主要特性

• LSP 集成：支持語言智能，讓代碼編輯更智能。
• 安全文件系統操作：帶有嚴格訪問控制，保障文件操作安全。
• 會話式編輯與狀態管理：方便開發者進行會話式編輯並管理狀態。
• 深度語言支持：對 TypeScript/JavaScript 進行深度分析，還支持 React 組件檢測與操作。
• 保持格式的編輯操作：確保編輯代碼時格式不被破壞。
• 全面的日誌記錄和錯誤跟蹤：便於開發者排查問題。

📦 安裝指南

# 安裝依賴項
npm install

# 構建項目
npm run build

# 運行測試
npm test

💻 使用示例

基礎用法

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

開發狀態

項目目前處於開發階段，未來會持續更新和優化功能。

📄 許可證

本項目的貢獻相關信息請參考CONTRIBUTING.md 。歡迎社區貢獻者參與項目開發！