Codesavant Coding Assistant

🚀 MCP-CodeSavant

CodeSavant は現在開発中のプロジェクトです。これは Model Context Protocol (MCP) に基づくサーバーで、コードの操作、実行、バージョン管理機能を提供します。AI アシスタントがコードの読み取り、書き込み、実行を行い、同時にコードの変更履歴を維持することができます。

✨ 主な機能

• コードファイルの読み取りと書き込みをサポートし、行単位での特定の操作が可能
• 複数のプログラミング言語（Python、Node.js）でコードを実行
• 制御された環境でシェルコマンドを実行
• コードの変更を追跡し、バージョン管理
• コードファイル内で内容を検索
• コードを以前のバージョンに復元

📦 インストール

1. リポジトリをクローンします：

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

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

pip install -r requirements.txt

3. サーバーの設定をあなたのClaudeデスクトップのconfig.jsonファイルに追加します：

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

📚 ドキュメント

ディレクトリ構造

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

workspaces/
├── project1/
│   ├── .code_history.json
│   └── [コードファイル]
├── project2/
│   ├── .code_history.json
│   └── [コードファイル]
└── ...

ツールリファレンス

1. コードファイルの読み取り

• 機能：指定されたパスのコードファイルの内容を読み取ります。
• 入力例：

{
    "project": "myproject",
    "path": "src/main.js"
}

• 出力例：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "content": "console.log('Hello World!');"
    }
}

2. コードファイルの行単位の読み取り

• 機能：指定された開始行と終了行でコードファイルの内容を読み取ります。
• 入力例：

{
    "project": "myproject",
    "path": "src/main.js",
    "start_line": 1,
    "end_line": 5
}

• 出力例：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "content": "console.log('Hello World!');\n// 第二行注释"
    }
}

3. コードの実行

• 機能：指定された言語環境でコードを実行します。
• 入力例（Python）：

{
    "language": "python",
    "code": "print('Hello World!')"
}

• 出力例：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "output": "'Hello World!'\n"
    }
}

4. シェルコマンドの実行

• 機能：制御された環境でシェルコマンドを実行します。
• 入力例：

{
    "command": "ls -a"
}

• 出力例：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "output": ". .. .bashrc .config ..."
    }
}

5. コードのバージョンへの復元

• 機能：コードファイルを指定されたタイムスタンプのバージョンに復元します。
• 入力例：

{
    "path": "src/main.js",
    "timestamp": 1234567890
}

• 出力例：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "diff": {
            "changes": [["- console.log('Hello World!');", "+ console.log('Hi there!');"], ...],
            "timestamp": 1234567890
        }
    }
}

エラー処理

サーバーは以下の形式で詳細なエラー応答を提供します：

{
    "success": false,
    "timestamp": 1234567890,
    "data": null,
    "error": "エラーメッセージ"
}

考えられるエラータイプは以下の通りです：

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

言語サポート

現在、コード実行には以下の言語がサポートされています：

• Python（システムのPythonインタープリターを使用）
• Node.js（nodeコマンドを使用）

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

貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. 新しいプルリクエストを作成します。

📄 ライセンス

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

作者

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

謝辞

• Model Context Protocol (MCP) を使用して構築されています。
• Anthropic の Claude 用に開発されています。