Python REPL

🚀 Python ローカル MCP サーバ

Python の対話型 REPL（読み取り - 評価 - 出力サイクル）環境を提供する MCP サーバです。

🚀 クイックスタート

このサーバは、Python の対話型 REPL 環境を提供し、REPL セッションの履歴にアクセスする機能や、Python コードを実行するツールを備えています。

✨ 主な機能

🔍 リソース

このサーバは、REPL セッション履歴へのアクセス機能を提供します。

• カスタムの repl:// URI スキームを使用してセッション履歴にアクセスできます。
• 各セッションの履歴は、純粋なテキストリソースとして表示できます。
• 履歴には、実行された各入力コードと対応する出力が表示されます。

🛠️ ツール

このサーバは、以下のツールを実装しています。

• python_repl：永続的なセッションで Python コードを実行します。
  • code（実行する Python コード）と session_id（必須パラメータ）を受け取ります。
  • 各セッションの独立した状態を維持します。
  • 式と文をサポートします。
  • stdout/stderr 出力をキャプチャして返します。

📦 インストール

⚙️ アプリケーション内設定

• MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json%

🚧 開発

📦 ビルドと公開

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージをビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとホイール形式の配布物が作成されます。

3. PyPI に公開します。

uv publish

注意: PyPI の認証情報を環境変数またはコマンドフラグで設定する必要があります。

• トークン: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME と --password/UV_PUBLISH_PASSWORD

🐞 デバッグ

MCP サーバは stdio で動作するため、デバッグが難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

以下のコマンドを使用して、npm から MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/python_local run python-local

起動後、Inspector は URL を表示し、ブラウザでその URL にアクセスすることでデバッグを開始できます。