Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • SMTP MCP Server
  • SQLite MCP Server
  • CouchDB MCP Server
  • MCP SSH Server
  • Ramp MCP Server
Back to MCP Servers
CodeSavant

CodeSavant

Public
twolven/mcp-codesavant

Model Context Protocol server enabling AI assistants to read, write, execute code in multiple languages, manage version control, run shell commands, and track code history for efficient code manipulation and execution.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with CodeSavant

MCP Server

Unlock the full potential of CodeSavant through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

MCP-CodeSavant

CodeSavant is a WIP project.

CodeSavant is a Model Context Protocol (MCP) server that provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.

Features

  • Read and write code files with line-specific operations
  • Execute code in multiple programming languages (Python, Node.js)
  • Execute shell commands in a controlled environment
  • Track and manage code changes with version control
  • Search within code files
  • Revert to previous versions of code

Installation

  1. Clone the repository:
git clone https://github.com/twolven/mcp-codesavant.git cd mcp-codesavant
  1. Install the required dependencies:
pip install -r requirements.txt
  1. Add the server configuration to your Claude Desktop config.json:
{ "mcpServers": { "codesavant": { "command": "python", "args": ["path/to/codesavant.py"] } } }

Directory Structure

The server creates and manages the following directory structure:

workspaces/
├── project1/
│   ├── .code_history.json
│   └── [code files]
├── project2/
│   ├── .code_history.json
│   └── [code files]
└── ...

Tool Reference

Detailed Usage

1. read_code_file

Read contents of a code file, optionally searching for specific sections.

{ "project": "string", // Project name "path": "string", // Path to file relative to project workspace "search": "string" // (Optional) Text/pattern to search for in file }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "content": "string", // File content "start_line": number, // (Only if search used) Starting line of found section "end_line": number // (Only if search used) Ending line of found section } }

2. write_code_file

Write or update specific lines in a code file.

{ "project": "string", // Project name "path": "string", // Path to file relative to workspace "content": "string", // Content to write (just the lines being changed) "start_line": number, // Starting line number for the change "end_line": number // (Optional) Ending line number for the change }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "diff": { "changes": [ // List of changes made [string, number, number, number, number] // (type, old_start, old_end, new_start, new_end) ], "timestamp": number // When the change was made } } }

3. get_code_history

Get change history for a code file.

{ "path": "string" // Path to file relative to workspace }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "history": [ { "changes": [ // List of changes made [string, number, number, number, number] ], "timestamp": number } ] } }

4. execute_code_command

Execute a code-related shell command.

{ "command": "string", // Shell command to execute "timeout": number // (Optional) Command timeout in seconds (default: 30) }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "state": "success|error|timeout|cancelled", "output": "string", // Command output "error": "string", // Error message if any "runtime": number, // Execution time in seconds "exit_code": number // Command exit code } }

5. execute_code

Execute code in specified language.

{ "code": "string", // Code to execute "language": "string", // Programming language ("python" or "node") "timeout": number // (Optional) Execution timeout in seconds (default: 30) }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "state": "success|error|timeout|cancelled", "output": "string", // Code execution output "error": "string", // Error message if any "runtime": number, // Execution time in seconds "exit_code": number // Execution exit code } }

6. revert_to_version

Revert a code file to a specific version.

{ "path": "string", // Path to file relative to workspace "timestamp": number // Timestamp of version to revert to }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "diff": { "changes": [ // List of changes made [string, number, number, number, number] ], "timestamp": number // When the reversion was made } } }

7. read_code_file_lines

Read specific lines from a code file.

{ "project": "string", // Project name "path": "string", // Path to file relative to project workspace "start_line": number, // Starting line number to read "end_line": number // (Optional) Ending line number to read }

Response:

{ "success": true, "timestamp": 1234567890, "data": { "content": "string" // Content of the specified lines } }

Error Handling

The server provides detailed error responses in the following format:

{ "success": false, "timestamp": 1234567890, "data": null, "error": "Error message" }

Error types include:

  • CodeFileError: File operation errors
  • CodeValidationError: Code validation errors
  • CodeExecutionError: Code execution errors

Language Support

Currently supported languages for code execution:

  • Python (using system Python interpreter)
  • Node.js (using node command)

Each language execution creates a temporary file in the workspace directory and executes it with appropriate interpreter.

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a new Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Todd Wolven - (https://github.com/twolven)

Acknowledgments

  • Built with the Model Context Protocol (MCP) by Anthropic
  • Developed for use with Anthropic's Claude
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • SMTP MCP Server
    SMTP MCP Server

    Model Context Protocol server enabling AI assistants to send and manage emails with multiple SMTP co...

    11 tools
    Added May 30, 2025
  • SQLite MCP Server
    SQLite MCP Server

    A Model Context Protocol server enabling AI models to execute SQL queries, manage SQLite database sc...

    Added May 30, 2025
  • CouchDB MCP Server
    CouchDB MCP Server

    Model Context Protocol server enabling AI assistants to manage CouchDB databases and documents with ...

    9 tools
    Added May 30, 2025
  • MCP SSH Server
    MCP SSH Server

    Secure Model Context Protocol (MCP) SSH server enabling remote command execution, file and directory...

    Added May 30, 2025
  • Ramp MCP Server
    Ramp MCP Server

    Model Context Protocol server enabling efficient retrieval, analysis, and task execution on Ramp dat...

    Added May 30, 2025