MCP Python ツールボックス
Python 開発用の包括的なツール セットを提供する Model Context Protocol (MCP) サーバー。これにより、Claude のような AI アシスタントが Python コードやプロジェクトを効果的に操作できるようになります。
概要
MCP Python Toolboxは、モデルコンテキストプロトコルサーバーを実装しており、クロードは標準化されたインターフェースを通じてPython開発タスクを実行できます。これにより、クロードは以下のことが可能になります。
- ワークスペース内でのファイルの読み取り、書き込み、管理
- Python コードを分析、フォーマット、リンティングする
- 仮想環境と依存関係を管理する
- Pythonコードを安全に実行する
特徴
ファイル操作 ( FileOperations )
- ワークスペースディレクトリ内での安全なファイル操作
- ワークスペース外への不正アクセスを防ぐためのパス検証
- 行単位の操作でファイルを読み書きする
- ファイルとディレクトリの作成と削除
- 詳細なメタデータ（サイズ、タイプ、変更時刻）を含むディレクトリの内容を一覧表示します
- ファイル書き込み時の親ディレクトリの自動作成
コード分析 ( CodeAnalyzer )
- AST を使用して Python コード構造を解析する
- 以下の詳細情報を抽出します:
- インポート文とそのエイリアス
- 引数とデコレータを使用した関数定義
- 基本クラスとメソッドを使用したクラス定義
- グローバル変数の割り当て
- 次を使用してコードをフォーマットします。
- 黒（デフォルト）
- PEP8 (autopep8 を使用)
- Pylintを使用した包括的なコードリンティングと詳細なレポート
プロジェクト管理 ( ProjectManager )
- pip サポートを使用して仮想環境を作成および管理します
- 柔軟な依存関係管理:
- requirements.txt からインストールする
- pyproject.tomlからインストールする
- 特定のパッケージバージョンのサポート
- 高度な依存関係の処理:
- パッケージ間のバージョンの競合を確認する
- インストールされているすべてのパッケージをバージョンとともに一覧表示します
- パッケージを特定のバージョンに更新する
- 現在の環境から requirements.txt を生成する
コード実行 ( CodeExecutor )
- 制御された環境でPythonコードを実行する
- 一貫した依存関係のためにプロジェクトの仮想環境を使用する
- コード実行のための一時ファイル管理
- stdout、stderr、終了コードをキャプチャする
- カスタム作業ディレクトリのサポート
インストール
- リポジトリをクローンします。
git clone https://github.com/gianlucamazza/mcp_python_toolbox.git
cd mcp_python_toolbox
- 仮想環境を作成してアクティブ化します。
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# or
.venv\Scripts\activate # Windows
- 開発モードでパッケージをインストールします。
使用法
CLIツールとして実行
サーバーを起動する最も簡単な方法は、CLI を使用することです。
# Start with current directory as workspace
python -m mcp_python_toolbox
# Or specify a workspace directory
python -m mcp_python_toolbox --workspace /path/to/your/project
Claude Desktop の設定
Claude Desktopは、MCP Python Toolboxサーバーを自動的に起動・管理できます。設定方法は以下の通りです。
- 上記の説明に従ってMCP Python Toolboxをインストールしてセットアップします。
- Claude Desktop の MCP ツール構成に Python Toolbox の構成エントリを追加します。
"python-toolbox": {
"command": "/Users/username/path/to/mcp_python_toolbox/.venv/bin/python",
"args": [
"-m",
"mcp_python_toolbox",
"--workspace",
"/Users/username/path/to/workspace"
],
"env": {
"PYTHONPATH": "/Users/username/path/to/mcp_python_toolbox/src",
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
"VIRTUAL_ENV": "/Users/username/path/to/mcp_python_toolbox/.venv",
"PYTHONHOME": ""
}
}
- 環境に合わせてパスをカスタマイズする
- Claude Desktopは必要に応じてMCPサーバーを自動的に起動します。
- クロードはMCPインターフェースを通じてPython開発ツールにアクセスできるようになりました
プログラムによる使用
from mcp_python_toolbox import PythonToolboxServer
server = PythonToolboxServer(workspace_root="/path/to/your/project")
server.setup()
server.run()
コアモジュールの例
ファイル操作
from mcp_python_toolbox.core import FileOperations
file_ops = FileOperations(workspace_root="/path/to/project")
# Read file contents
content = file_ops.read_file("src/example.py")
# Read specific lines
lines = file_ops.read_file("src/example.py", start_line=10, end_line=20)
# Write to file
file_ops.write_file("output.txt", "Hello, World!")
# Append to file
file_ops.write_file("log.txt", "New entry\n", mode='a')
# List directory contents
contents = file_ops.list_directory("src")
for item in contents:
print(f"{item['name']} - {item['type']} - {item['size']} bytes")
コード分析
from mcp_python_toolbox.core import CodeAnalyzer
analyzer = CodeAnalyzer(workspace_root="/path/to/project")
# Analyze Python file structure
analysis = analyzer.parse_python_file("src/example.py")
print(f"Found {len(analysis['functions'])} functions")
print(f"Found {len(analysis['classes'])} classes")
# Format code
formatted = analyzer.format_code(code, style='black')
# Lint code
issues = analyzer.lint_code("src/example.py")
for issue in issues:
print(f"Line {issue['line']}: {issue['message']}")
プロジェクト管理
from mcp_python_toolbox.core import ProjectManager
pm = ProjectManager(workspace_root="/path/to/project")
# Create virtual environment
pm.create_virtual_environment()
# Install dependencies
pm.install_dependencies() # from requirements.txt or pyproject.toml
pm.install_dependencies("requirements-dev.txt") # from specific file
# Check for conflicts
conflicts = pm.check_dependency_conflicts()
if conflicts:
print("Found dependency conflicts:")
for conflict in conflicts:
print(f"{conflict['package']} requires {conflict['requires']}")
# Update packages
pm.update_package("requests") # to latest
pm.update_package("flask", version="2.0.0") # to specific version
コード実行
from mcp_python_toolbox.core import CodeExecutor
executor = CodeExecutor(workspace_root="/path/to/project")
code = '''
def greet(name):
return f"Hello, {name}!"
print(greet("World"))
'''
result = executor.execute_code(code)
print(f"Output: {result['stdout']}")
print(f"Errors: {result['stderr']}")
print(f"Exit code: {result['exit_code']}")
発達
テストの実行
型チェック
mypy src/mcp_python_toolbox
リンティング
pylint src/mcp_python_toolbox
書式設定
black src/mcp_python_toolbox
貢献
- リポジトリをフォークする
- 機能ブランチを作成します（
git checkout -b feature/amazing-feature ） - 変更をコミットします (
git commit -m 'Add some amazing feature' ) - ブランチにプッシュする (
git push origin feature/amazing-feature ) - プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
謝辞
- モデルコンテキストプロトコル仕様を実装する
- 最新のPython開発ツールとベストプラクティスに基づいて構築
- 業界標準のフォーマット（Black）およびリンティング（Pylint）ツールを使用