cedardiff MCP Server

使用 CEDARScript 语法规则编辑文件

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

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

功能

语法

• 类似 SQL 的代码操作语法（DDL、DML）
• 支持针对文件、函数、类和方法
• 使用正则表达式、前缀/后缀和缩进规则进行模式匹配
• 块级代码操作能力

工具

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

实现状态

当前测试显示：

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

开发

安装依赖项：

npm install

构建服务器：

npm run build

带有自动重建的开发环境：

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