MCP-コードサヴァント

CodeSavant は現在進行中のプロジェクトです。

CodeSavantは、コード操作、実行、バージョン管理機能を提供するModel Context Protocol（MCP）サーバーです。AIアシスタントが変更履歴を維持しながらコードの読み取り、書き込み、実行を行うことを可能にします。

特徴

行単位の操作でコードファイルを読み書きする
複数のプログラミング言語（Python、Node.js）でコードを実行する
制御された環境でシェルコマンドを実行する
バージョン管理でコードの変更を追跡および管理する
コードファイル内を検索
以前のバージョンのコードに戻す

インストール

リポジトリをクローンします。

git clone https://github.com/twolven/mcp-codesavant.git
cd mcp-codesavant

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

pip install -r requirements.txt

Claude Desktop の config.json にサーバー構成を追加します。

{
  "mcpServers": {
    "codesavant": {
      "command": "python",
      "args": ["path/to/codesavant.py"]
    }
  }
}

ディレクトリ構造

サーバーは次のディレクトリ構造を作成および管理します。

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

ツールリファレンス

詳細な使用方法

1. コードファイルを読む

コードファイルの内容を読み取り、オプションで特定のセクションを検索します。

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

応答：

{
    "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. コードファイルの書き込み

コードファイル内の特定の行を書き込むか更新します。

{
    "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
}

応答：

{
    "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. コード履歴を取得する

コードファイルの変更履歴を取得します。

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

応答：

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

4. コードコマンドの実行

コード関連のシェルコマンドを実行します。

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

応答：

{
    "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. 実行コード

指定された言語でコードを実行します。

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

応答：

{
    "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. バージョンに戻す

コードファイルを特定のバージョンに戻します。

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

応答：

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

7. コードファイルの行を読み取る

コードファイルから特定の行を読み取ります。

{
    "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
}

応答：

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

エラー処理

サーバーは、次の形式で詳細なエラー応答を提供します。

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

エラーの種類は次のとおりです:

CodeFileError : ファイル操作エラー
CodeValidationError : コード検証エラー
CodeExecutionError : コード実行エラー

言語サポート

現在コード実行にサポートされている言語:

Python (システム Python インタープリタを使用)
Node.js (node コマンドを使用)

各言語の実行では、ワークスペースディレクトリに一時ファイルが作成され、適切なインタープリターで実行されます。

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
新しいプルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

著者

トッド・ウルブン - ( https://github.com/twolven )

謝辞

Anthropicのモデルコンテキストプロトコル（MCP）を使用して構築
アントロピックのクロードとの使用のために開発されました

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

コード操作、実行、バージョン管理機能を提供します。AIアシスタントは、変更履歴を維持しながらコードの読み取り、書き込み、実行を行うことができます。

Related MCP Servers

XiaoZhi MCP Aggregate
avxxoo
-
security
F
license
-
quality
A powerful interface for extending AI capabilities through remote control, calculations, email operations, knowledge search, and more.
Last updated -
38
My Coding Buddy MCP Server
ajkeast
-
security
F
license
-
quality
A personal AI coding assistant that connects to various development environments and helps automate tasks, provide codebase insights, and improve coding decisions by leveraging the Model Context Protocol.
Last updated -
Document Automation MCP Server
vedantparmar12
-
security
A
license
-
quality
A sophisticated server that enables AI assistants to automatically analyze codebases and generate comprehensive, professional documentation.
Last updated -
1
MIT License
Context Optimizer MCP Server
malaksedarous
-
security
A
license
-
quality
Provides AI coding assistants with context optimization tools including targeted file analysis, intelligent terminal command execution with LLM-powered output extraction, and web research capabilities. Helps reduce token usage by extracting only relevant information instead of processing entire files and command outputs.
Last updated -
5
13
43
TypeScript
MIT License

View all related MCP servers

CodeSavant

MCP-コードサヴァント

特徴

インストール

ディレクトリ構造

ツールリファレンス

詳細な使用方法

1. コードファイルを読む

2. コードファイルの書き込み

3. コード履歴を取得する

4. コードコマンドの実行

5. 実行コード

6. バージョンに戻す

7. コードファイルの行を読み取る

エラー処理

言語サポート

貢献

ライセンス

著者

謝辞

Related MCP Servers

XiaoZhi MCP Aggregate

My Coding Buddy MCP Server

Document Automation MCP Server

Context Optimizer MCP Server

Appeared in Searches

New MCP Servers

MCP directory API