python_local MCP Server

python_local MCP サーバー

インタラクティブな Python REPL（Read-Eval-Print Loop）環境を提供する MCP サーバーです。

コンポーネント

リソース

サーバーは REPL セッションの履歴にアクセスできます。

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

ツール

サーバーは 1 つのツールを実装しています。

• python_repl：永続セッションで Python コードを実行します
  • 必須の引数として、code（実行する Python コード）と session_id を受け取ります
  • セッションごとに個別の状態を維持します
  • 式と文の両方をサポートします
  • stdout/stderr の出力を取得して返します

設定

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発中／未公開サーバーの設定

```json "mcpServers": { "python_local": { "command": "uv", "args": [ "--directory", "/path/to/python_local", "run", "python_local" ] } } ```

公開済みサーバーの設定

```json "mcpServers": { "python_local": { "command": "uvx", "args": [ "python_local" ] } } ```

開発

ビルドと公開

パッケージを配布できる状態にするには、次の手順を実行します。

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 にブラウザーからアクセスして、デバッグを開始できます。