コードサヴァント

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

MySQL MCP Server
designcomputer
A
security
A
license
A
quality
Allows AI assistants to list tables, read data, and execute SQL queries through a controlled interface, making database exploration and analysis safer and more structured.
Last updated -
1
580
Python
MIT License
mcp-codex-keeper
aindreyway
-
security
A
license
-
quality
Serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices.
Last updated -
4
87
52
TypeScript
MIT License
Metabase MCP Server
imlewc
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase databases and dashboards, allowing users to list and execute queries, access data visualizations, and interact with database resources through natural language.
Last updated -
25
JavaScript
Targetprocess MCP Server
aaronsb
A
security
A
license
A
quality
Provides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.
Last updated -
5
4
TypeScript
MIT License

View all related MCP servers

CodeSavant

MCP-コードサヴァント

特徴

インストール

ディレクトリ構造

ツールリファレンス

詳細な使用方法

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

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

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

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

5. 実行コード

6. バージョンに戻す

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

エラー処理

言語サポート

貢献

ライセンス

著者

謝辞

Related MCP Servers

MySQL MCP Server

mcp-codex-keeper

Metabase MCP Server

Targetprocess MCP Server

Appeared in Searches

New MCP Servers

MCP directory API