Cedarscript File Manipulation

🚀 CEDAR diff MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，實現了 CEDARScript 語言（類似於 SQL）用於代碼操作。它提供了全面的代碼操作語法、執行 CEDARScript 操作的工具，還支持複雜模式匹配和轉換，為代碼操作帶來了便利。

✨ 主要特性

語法

• 採用類似於 SQL 的代碼操作語法，涵蓋數據定義語言和數據操作語言。
• 支持在文件、函數、類和方法級別進行目標定位。
• 可使用正則表達式、前綴/後綴規則以及縮進規則進行模式匹配。
• 具備塊級代碼操作功能。

工具

• edit_file：用於執行 CEDARScript 命令。
  • 可接受腳本和工作目錄作為參數。
  • 支持文件的創建、刪除、移動和更新操作。
  • 提供基於模式的代碼轉換功能。

🔧 技術細節

經過測試，我們發現：

• 命令解析功能正常。
• 語法支持複雜的操作。
• 文件寫入機制需要改進。
• 雖然返回成功消息，但更改未被持久化。

📦 安裝指南

開發依賴安裝

安裝項目所需的依賴項：

npm install

服務器構建

構建服務器：

npm run build

自動重建開發

使用 watch 進行自動重建開發：

npm run watch

在 Claude Desktop 上安裝

要在 Claude Desktop 上使用，請添加以下配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cedardiff": {
      "command": "/path/to/cedardiff/build/index.js"
    }
  }
}

💻 使用示例

調試

由於 MCP 服務器通過標準輸入和輸出進行通信，調試可能較為困難。我們推薦使用 MCP Inspector，這是一個作為包腳本提供的工具：

npm run inspector

Inspector 將提供一個訪問調試工具的 URL，您可以在瀏覽器中打開。

📚 詳細文檔

ES 模塊遷移

該項目已遷移到使用 ES 模塊。主要改動包括：

• 在 package.json 中添加了 "type": "module"。
• 更新 tsconfig.json 以使用 "module": "ESNext"。
• 將導入/導出語句轉換為 ES 模塊語法。
• 更新類型定義以兼容 ES 模塊。

兼容性注意事項

⚠️ 重要提示

• 確保使用 Node.js 版本 12 或更高版本。
• 使用 import 而不是 require() 進行模塊導入。
• 在導入本地文件時使用 .js 擴展名。