CEDAR diff MCP 服务器

功能介绍

这是一个基于 TypeScript 的 MCP 服务器，实现了 CEDARScript，一种类似于 SQL 的语言，用于代码操作。它提供了以下功能：

• 全面的代码操作语法
• 执行 CEDARScript 操作的工具
• 复杂模式匹配和转换的支持

特性

语法

• 类似于 SQL 的代码操作语法（数据定义语言、数据操作语言）
• 支持文件、函数、类和方法级别的目标定位
• 使用正则表达式、前缀/后缀规则以及缩进规则进行模式匹配
• 提供块级代码操作功能

工具

• edit_file - 执行 CEDARScript 命令
  • 接受脚本和工作目录作为参数
  • 支持文件的创建、删除、移动和更新
  • 提供基于模式的代码转换功能

实现状态

经过测试，我们发现：

• 命令解析功能正常
• 语法支持复杂的操作
• 文件写入机制需要改进
• 虽然返回成功消息，但更改未被持久化

开发

安装依赖项：

npm install

构建服务器：

npm run build

使用 watch 进行自动重建开发：

npm run watch

安装

要在 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 扩展名