MCP Python Interpreter

🚀 MCP Python インタープリター

Model Context Protocol (MCP) サーバーで、LLM が Python 環境とやり取りし、ファイルの読み書き、Python コードの実行、開発ワークフローの管理を行うことができます。

✨ 主な機能

• 環境管理：異なる Python 環境（システムと conda）を一覧表示し、使用することができます。
• コード実行：利用可能な任意の環境で Python コードまたはスクリプトを実行できます。
• パッケージ管理：インストールされているパッケージを一覧表示し、新しいパッケージをインストールできます。
• ファイル操作：
  • 任意のタイプのファイル（テキスト、ソースコード、バイナリ）を読み取ることができます。
  • テキストおよびバイナリファイルを書き込むことができます。
• Python プロンプトテンプレート：関数の作成やデバッグなど、一般的な Python タスクのテンプレートが用意されています。

📦 インストール

pip を使用して MCP Python インタープリターをインストールするには、以下のコマンドを実行します。

pip install mcp-python-interpreter

または、uv を使用する場合は、以下のコマンドを実行します。

uv install mcp-python-interpreter

💻 使用例

基本的な使用法

Claude Desktop との連携方法は以下の通りです。

1. Claude Desktop をインストールします。
2. Claude Desktop を開き、メニューをクリックしてから設定を選択します。
3. 開発者タブに移動し、「編集設定」をクリックします。
4. claude_desktop_config.json に以下の内容を追加します。

{
  "mcpServers": {
    "mcp-python-interpreter": {
        "command": "uvx",
        "args": [
            "mcp-python-interpreter",
            "--dir",
            "/path/to/your/work/dir",
            "--python-path",
            "/path/to/your/python"
        ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

Windows の場合：

{
  "mcpServers": {
    "python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "C:\\path\\to\\your\\working\\directory",
        "--python-path",
        "/path/to/your/python"
      ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

5. Claude Desktop を再起動します。
6. これで、チャット画面に MCP ツールのアイコンが表示されるはずです。

--dir パラメータは必須で、すべてのファイルの保存と実行が行われる場所を指定します。これにより、特定のディレクトリに MCP サーバーを隔離することでセキュリティを維持するのに役立ちます。

高度な使用法

前提条件

• pip と uv がインストールされていることを確認してください。
• Python インタープリターがインストールされていることを確認してください。

利用可能なツール

• 環境管理：複数バージョンの Python 環境をサポートし、conda 環境を自動検出します。
• コード実行：セキュアなコードサンドボックスで、ファイルアクセス権限を制限します。
• パッケージ管理：pip と conda を通じてパッケージのインストール/アンインストールを行います。
• ファイル操作：ファイルパスを厳密に制御し、悪意のある書き込みを防止します。

リソース

• API ドキュメント：各インターフェースの機能と使い方を詳細に説明しています。
• サンプルコード：一般的なシナリオの使用例を提供しています。
• 問題解決：一般的な問題とその解決策が記載されています。

コードの実行例

# 例 1: 簡単な計算
result = 2 + 3
print(result)  # 出力 5

# 例 2: ファイル操作
with open("test.txt", "w") as f:
    f.write("Hello, World!")

ファイル処理能力

• ファイルの読み取り：テキストおよびバイナリファイルをサポートし、最大制限は 1MB です。
• ファイルの書き込み：作業ディレクトリ内で厳密に制御されます。
• 構文ハイライト：ソースコードファイルのハイライト表示が可能です。
• 16 進数表現：バイナリファイルの 16 進数エスケープが可能です。

セキュリティに関する注意事項

この MCP サーバーは、Python 環境とファイルシステムにアクセスできます。主要なセキュリティ機能は以下の通りです。

• 隔離された作業ディレクトリ
• ファイルサイズ制限
• 作業ディレクトリ外への書き込み防止
• 明示的な上書き保護

不完全に理解していないコードやファイル操作を実行する場合は常に注意してください。

📄 ライセンス

MIT