Cedarscript File Manipulation

🚀 CEDAR diff MCP サーバー

このプロジェクトは、TypeScript をベースにした MCP サーバーです。CEDARScript という SQL に似た言語を実装し、コード操作を行うことができます。このサーバーは、コード操作のための包括的な機能を提供し、複雑なパターンマッチングと変換をサポートします。

✨ 主な機能

機能紹介

このサーバーは、CEDARScript という SQL に似た言語を用いたコード操作を実現します。以下の機能を提供します。

• 包括的なコード操作構文
• CEDARScript 操作を実行するツール
• 複雑なパターンマッチングと変換のサポート

構文

• SQL に似たコード操作構文（データ定義言語、データ操作言語）
• ファイル、関数、クラス、メソッドレベルの対象指定をサポート
• 正規表現、接頭辞/接尾辞ルール、インデントルールを用いたパターンマッチング
• ブロックレベルのコード操作機能を提供

ツール

• edit_file - CEDARScript コマンドを実行
  • スクリプトと作業ディレクトリをパラメータとして受け取ります
  • ファイルの作成、削除、移動、更新をサポート
  • パターンベースのコード変換機能を提供

🔧 技術詳細

実装状況

テストの結果、以下のことがわかりました。

• コマンド解析機能は正常に動作します
• 構文は複雑な操作をサポートします
• ファイル書き込みメカニズムの改善が必要です
• 成功メッセージが返されますが、変更が永続化されません

ES モジュールへの移行

このプロジェクトは ES モジュールの使用に移行しました。主な変更点は以下の通りです。

• package.json に "type": "module" を追加
• tsconfig.json を "module": "ESNext" を使用するように更新
• インポート/エクスポート文を ES モジュール構文に変換
• ES モジュールと互換性のある型定義を更新

互換性に関する注意事項

• Node.js バージョン 12 以上を使用することを確認してください
• モジュールのインポートには import を使用し、require() は使用しないでください
• ローカルファイルをインポートする際には .js 拡張子を使用してください

📦 インストール

開発環境のセットアップ

依存関係をインストールします。

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 を提供し、ブラウザで開くことができます。