Cedarscript MCP

What is cedarscript-mcp

cedarscript-mcp is a TypeScript-based Model Context Protocol (MCP) server developed by the company th3w1zard1. It is designed to facilitate code manipulation using CEDARScript, a SQL-like language. This server allows users to edit files by applying a comprehensive set of grammar rules for code operations. CEDARScript enables sophisticated pattern matching and transformations, making it a powerful tool for developers who need precise code manipulation capabilities.

How to Use cedarscript-mcp

To start using cedarscript-mcp, you'll need to set up your development environment. Begin by installing the required dependencies using the following command:

npm install

Next, build the server:

npm run build

For ongoing development, use the following command that supports auto-rebuild:

npm run watch

Once set up, you can execute CEDARScript commands using the edit_file tool. This tool requires a script and a working directory as parameters and supports various file operations such as creation, deletion, moving, and updating. While executing commands, note that pattern-based transformations are supported, although some file writing mechanisms may still be under development.

To integrate cedarscript-mcp with Claude Desktop, you can configure the server settings in the appropriate configuration file for your operating system. This integration allows for seamless execution of CEDARScript commands in your preferred development environment.

Key Features of cedarscript-mcp

Grammar

• SQL-like Syntax: Utilizes a familiar syntax for defining code operations, including Data Definition Language (DDL) and Data Manipulation Language (DML) commands.
• Flexible Targeting: Supports operations targeting files, functions, classes, and methods.
• Advanced Pattern Matching: Employs regex, prefix/suffix, and indentation rules for precise pattern matching.
• Block-Level Manipulation: Allows for comprehensive code block manipulations.

Tools

• edit_file: A versatile tool for executing CEDARScript commands with functionalities for managing and transforming files based on specified patterns.

Development and Debugging

• The server is in active development, with ongoing improvements, particularly in file writing mechanisms.
• For debugging, the project provides an inspector tool to assist in reviewing server communications and operations.

ES Module Compatibility

• The project has been migrated to use ES modules, enhancing its modern compatibility. This includes changes in import/export statements and other structural updates.

By leveraging these features, cedarscript-mcp offers a robust platform for developers looking to automate and refine their code manipulation processes. Whether you're managing large codebases or performing targeted code transformations, cedarscript-mcp provides the tools needed to enhance your coding efficiency.