Python MCP Server

🚀 Python MCP サーバー

Python コードを実行し、Python 環境を管理するためのモデルコンテキストプロトコル (MCP) サーバーです。このサーバーは、Claude や他の大規模言語モデルが Python コードを実行し、ファイルを管理し、Python パッケージと相互作用することを可能にします。

✨ 主な機能

• コード実行：Python コード断片を実行するか、Python ファイルを実行します。
• ファイル管理：Python ファイルの一覧表示、読み取り、および書き込みを行います。
• Python 環境：Python のバージョンと環境情報を確認します。
• 設定可能な実行：タイムアウト時間、作業ディレクトリ、およびコマンドライン引数を設定します。

📦 インストール

前提条件

この MCP サーバーを使用する前に、以下をインストールしてください。

• Node.js（推奨バージョン：LTS）
• Python（推奨バージョン：3.6+）

インストール手順

リポジトリのクローン

git clone https://github.com/Timtech4u/python-mcp-server.git
cd python-mcp-server

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

📚 ドキュメント

Claude Desktop の設定

1. config.json ファイルを開きます。
2. 以下の内容を追加します。

   {
     "pythonPath": "C:/Python39/python.exe",
     "nodeModulesDir": "node_modules"
   }
   

3. ファイルを保存します。

Cline の設定

1. ターミナルを開き、以下のコマンドを実行します。

   mcp-config set pythonPath=C:\Python39\python.exe
   

💻 使用例

サンプル会話

コードの実行

{
  "command": "execute_python_code",
  "params": {
    "code": "print('Hello, World!')",
    "timeout": 30
  }
}

応答：

{
  "output": "Hello, World!\n"
}

ファイルの実行

{
  "command": "execute_python_file",
  "params": {
    "filePath": "./script.py",
    "args": ["arg1", "arg2"]
  }
}

利用可能なツール

Python コードの実行

• パラメータ：
  • code（文字列、必須）：実行する Python コード。
  • timeout（数値、オプション）：タイムアウト時間。デフォルトは 30 秒。

Python ファイルの実行

• パラメータ：
  • filePath（文字列、必須）：実行する Python ファイルのパス。
  • args（配列、オプション）：スクリプトに渡すコマンドライン引数。

トラブルシューティング

Python が見つからない場合

「Python がインストールされていません」というエラーが発生した場合は、Python が正しくインストールされ、システムの PATH 環境変数に追加されていることを確認してください。

権限問題

権限エラーが発生した場合は、MCP サーバーを実行しているユーザーがファイルにアクセスするのに十分な権限を持っていることを確認してください。

タイムアウト問題

デフォルトのタイムアウト時間は 30 秒です。延長する場合は、リクエストで timeout パラメータを指定してください。

📄 ライセンス

MIT