PyPI - mcp-stdio - Versions diffs - 0.3.2__tar.gz → 0.3.4__tar.gz - Mend

mcp-stdio 0.3.2tar.gz → 0.3.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/.github/workflows/release.yml RENAMED Viewed

@@ -8,13 +8,27 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v6
-      - name: Set up Python
+      - name: Verify __version__ matches tag
+        if: matrix.python-version == '3.12'
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG_VERSION=$(python3 -c "import re; print(re.search(r'__version__ = \"([^\"]+)\"', open('src/mcp_stdio/__init__.py').read()).group(1))")
+          if [ "$TAG" != "$PKG_VERSION" ]; then
+            echo "::error::Tag v$TAG does not match __version__ $PKG_VERSION in src/mcp_stdio/__init__.py"
+            exit 1
+          fi
+          echo "Verified: tag v$TAG matches __version__ $PKG_VERSION"
+      - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:
-          python-version: "3.12"
+          python-version: ${{ matrix.python-version }}
       - name: Install dependencies
         run: pip install -e ".[dev]"

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/.github/workflows/test.yml RENAMED Viewed

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.12", "3.14"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v6

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/PKG-INFO RENAMED Viewed

@@ -1,20 +1,22 @@
 Metadata-Version: 2.4
 Name: mcp-stdio
-Version: 0.3.2
-Summary: Stdio-to-HTTP relay for MCP servers
+Version: 0.3.4
+Summary: Stdio-to-HTTP relay — bridges MCP clients to remote HTTP MCP servers
 Project-URL: Homepage, https://github.com/shigechika/mcp-stdio
 Project-URL: Issues, https://github.com/shigechika/mcp-stdio/issues
 Author: Shigechika AIKAWA
 License-Expression: MIT
 License-File: LICENSE
-Keywords: claude,mcp,proxy,relay,stdio
+Keywords: bridge,claude,mcp,oauth,proxy,relay,stdio
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.10
@@ -30,11 +32,11 @@ Description-Content-Type: text/markdown
 English | [日本語](README.ja.md)
-Stdio-to-HTTP relay for MCP servers — bridges Claude Desktop/Code to remote Streamable HTTP endpoints.
+Stdio-to-HTTP relay — bridges MCP clients to remote HTTP MCP servers.
-## Why?
+## Overview
-[MCP](https://modelcontextprotocol.io/) clients like Claude Desktop and Claude Code see mcp-stdio as a locally running self-hosted MCP server, while it relays all requests to a remote MCP server over Streamable HTTP:
+[MCP](https://modelcontextprotocol.io/) clients like Claude Desktop and Claude Code see mcp-stdio as a locally running self-hosted MCP server, while it relays all requests to a remote MCP server with support for various authentication methods:
 ```mermaid
 flowchart BT
@@ -47,6 +49,25 @@ flowchart BT
 Bearer tokens, custom headers, and OAuth 2.1 credentials are forwarded to the remote server.
+## Features
+- **OAuth 2.1 client** — built-in authorization code flow with PKCE, dynamic client registration, token refresh, and secure token persistence. Implements the full MCP authorization spec:
+  - [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728) Protected Resource Metadata discovery
+  - [RFC 8414](https://www.rfc-editor.org/rfc/rfc8414) Authorization Server Metadata discovery
+  - [RFC 8707](https://www.rfc-editor.org/rfc/rfc8707) Resource Indicators for audience binding
+  - [RFC 7636](https://www.rfc-editor.org/rfc/rfc7636) PKCE with S256 challenge method
+  - [RFC 7591](https://www.rfc-editor.org/rfc/rfc7591) Dynamic Client Registration
+  - [RFC 6750](https://www.rfc-editor.org/rfc/rfc6750) Bearer Token usage
+- **Retry with backoff** — retries up to 3 times on connection errors
+- **Streaming resilience** — streams SSE responses in real time; retries on mid-stream disconnect
+- **Session recovery** — resets MCP session ID on 404 and retries
+- **Token refresh on 401** — automatically refreshes expired OAuth tokens mid-session
+- **Bearer token auth** — via `--bearer-token` flag or `MCP_BEARER_TOKEN` env var
+- **Custom headers** — pass any header with `-H`
+- **Graceful shutdown** — handles SIGTERM/SIGINT
+- **Proxy support** — respects `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` env vars via [httpx](https://www.python-httpx.org/)
+- **Minimal dependencies** — only [httpx](https://www.python-httpx.org/); OAuth uses stdlib only
 ## Install
 ```bash
@@ -90,7 +111,7 @@ mcp-stdio https://your-server.example.com:8080/mcp --bearer-token YOUR_TOKEN
 With custom headers:
 ```bash
-mcp-stdio https://your-server.example.com:8080/mcp -H "X-API-Key: YOUR_KEY"
+mcp-stdio https://your-server.example.com:8080/mcp --header "X-API-Key: YOUR_KEY"
 ```
 With OAuth 2.1 authentication (for servers that require it):
@@ -102,6 +123,12 @@ mcp-stdio --oauth https://your-server.example.com:8080/mcp
 mcp-stdio --oauth --client-id YOUR_CLIENT_ID https://your-server.example.com:8080/mcp
 ```
+Test connectivity before use:
+```bash
+mcp-stdio --test https://your-server.example.com:8080/mcp
+```
 ## Claude Desktop Configuration
 Add to `claude_desktop_config.json`:
@@ -146,7 +173,7 @@ Options:
   --oauth                Enable OAuth 2.1 authentication
   --client-id ID         Pre-registered OAuth client ID (or set MCP_OAUTH_CLIENT_ID)
   --oauth-scope SCOPE    OAuth scope to request
-  -H 'Key: Value'        Custom header (can be repeated)
+  -H, --header 'Key: Value'  Custom header (can be repeated)
   --timeout-connect SEC  Connection timeout (default: 10)
   --timeout-read SEC     Read timeout (default: 120)
   --test                 Test connection and exit
@@ -154,7 +181,7 @@ Options:
   -h, --help             Show help
 ```
-## Use Cases
+## Workarounds
 Works around known issues in Claude Code's HTTP transport:
@@ -162,27 +189,9 @@ Works around known issues in Claude Code's HTTP transport:
 - **Missing Accept header** — servers return 406, misinterpreted as auth failure ([#42470](https://github.com/anthropics/claude-code/issues/42470))
 - **OAuth fallback loop** — Claude Code enters OAuth discovery even when not needed ([#34008](https://github.com/anthropics/claude-code/issues/34008), [#39271](https://github.com/anthropics/claude-code/issues/39271))
 - **Session lost after disconnect** — mcp-stdio recovers MCP sessions automatically on 404 ([#34498](https://github.com/anthropics/claude-code/issues/34498), [#38631](https://github.com/anthropics/claude-code/issues/38631))
+- **OAuth scope omitted** — Claude Code sends no `scope` parameter in authorization requests, causing strict OAuth servers to reject the flow ([#4540](https://github.com/anthropics/claude-code/issues/4540)); mcp-stdio sends scopes via `--oauth-scope`
 - **Proxy settings ignored** — Claude Code does not respect `NO_PROXY` ([#34804](https://github.com/anthropics/claude-code/issues/34804)); mcp-stdio inherits proxy settings from httpx
-## Features
-- **OAuth 2.1 client** — built-in authorization code flow with PKCE, dynamic client registration, token refresh, and secure token persistence. Implements the full MCP authorization spec:
-  - [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728) Protected Resource Metadata discovery
-  - [RFC 8414](https://www.rfc-editor.org/rfc/rfc8414) Authorization Server Metadata discovery
-  - [RFC 8707](https://www.rfc-editor.org/rfc/rfc8707) Resource Indicators for audience binding
-  - [RFC 7636](https://www.rfc-editor.org/rfc/rfc7636) PKCE with S256 challenge method
-  - [RFC 7591](https://www.rfc-editor.org/rfc/rfc7591) Dynamic Client Registration
-  - [RFC 6750](https://www.rfc-editor.org/rfc/rfc6750) Bearer Token usage
-- **Retry with backoff** — retries up to 3 times on connection errors
-- **Streaming resilience** — streams SSE responses in real time; retries on mid-stream disconnect
-- **Session recovery** — resets MCP session ID on 404 and retries
-- **Token refresh on 401** — automatically refreshes expired OAuth tokens mid-session
-- **Bearer token auth** — via `--bearer-token` flag or `MCP_BEARER_TOKEN` env var
-- **Custom headers** — pass any header with `-H`
-- **Graceful shutdown** — handles SIGTERM/SIGINT
-- **Proxy support** — respects `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` env vars via [httpx](https://www.python-httpx.org/)
-- **Minimal dependencies** — only [httpx](https://www.python-httpx.org/); OAuth uses stdlib only
 ## How It Works
 1. If `--oauth` is set, obtains an access token (cached → refresh → browser flow)

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/README.ja.md RENAMED Viewed

@@ -2,11 +2,11 @@
 [English](README.md) | 日本語
-MCP サーバー向け stdio-to-HTTP リレー — Claude Desktop/Code とリモート Streamable HTTP エンドポイントを橋渡しします。
+Stdio-to-HTTP リレー — MCP クライアントとリモート HTTP MCP サーバーを橋渡しします。
-## なぜ必要？
+## 概要
-[MCP](https://modelcontextprotocol.io/) クライアント（Claude Desktop, Claude Code）に対してローカルで稼働するセルフホスト MCP サーバのように振る舞いつつ、リモート MCP サーバへの Streamable HTTP 接続を橋渡しします：
+[MCP](https://modelcontextprotocol.io/) クライアント（Claude Desktop, Claude Code）に対してローカルで稼働するセルフホスト MCP サーバのように振る舞いつつ、各種認証でリモート MCP サーバーへの接続を橋渡しします：
 ```mermaid
 flowchart BT
@@ -19,6 +19,25 @@ flowchart BT
 Bearer token、カスタムヘッダー、OAuth 2.1 認証情報をリモートサーバーへ転送します。
+## 特徴
+- **OAuth 2.1 クライアント** — 認可コードフロー（PKCE）、動的クライアント登録、トークンリフレッシュ、安全なトークン永続化を内蔵。MCP 認可仕様の関連 RFC に完全対応：
+  - [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728) Protected Resource Metadata の検出
+  - [RFC 8414](https://www.rfc-editor.org/rfc/rfc8414) Authorization Server Metadata の検出
+  - [RFC 8707](https://www.rfc-editor.org/rfc/rfc8707) Resource Indicators によるオーディエンス指定
+  - [RFC 7636](https://www.rfc-editor.org/rfc/rfc7636) PKCE（S256 チャレンジメソッド）
+  - [RFC 7591](https://www.rfc-editor.org/rfc/rfc7591) Dynamic Client Registration
+  - [RFC 6750](https://www.rfc-editor.org/rfc/rfc6750) Bearer Token の利用
+- **バックオフ付きリトライ** — 接続エラー時に最大3回リトライ
+- **ストリーミング耐性** — SSE レスポンスをリアルタイムで転送、切断時にリトライ
+- **セッション回復** — 404 でセッション ID をリセットして再試行
+- **401 時の自動トークンリフレッシュ** — セッション中に OAuth トークンが失効しても自動更新
+- **Bearer token 認証** — `--bearer-token` フラグまたは `MCP_BEARER_TOKEN` 環境変数
+- **カスタムヘッダー** — `-H` で任意のヘッダーを送信
+- **グレースフルシャットダウン** — SIGTERM/SIGINT ハンドリング
+- **プロキシ対応** — `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` 環境変数を [httpx](https://www.python-httpx.org/) 経由でサポート
+- **最小依存** — [httpx](https://www.python-httpx.org/) のみ; OAuth は stdlib のみ使用
 ## インストール
 ```bash
@@ -62,7 +81,7 @@ mcp-stdio https://your-server.example.com:8080/mcp --bearer-token YOUR_TOKEN
 カスタムヘッダー付き：
 ```bash
-mcp-stdio https://your-server.example.com:8080/mcp -H "X-API-Key: YOUR_KEY"
+mcp-stdio https://your-server.example.com:8080/mcp --header "X-API-Key: YOUR_KEY"
 ```
 OAuth 2.1 認証付き（OAuth 必須のサーバー向け）：
@@ -74,6 +93,12 @@ mcp-stdio --oauth https://your-server.example.com:8080/mcp
 mcp-stdio --oauth --client-id YOUR_CLIENT_ID https://your-server.example.com:8080/mcp
 ```
+接続テスト：
+```bash
+mcp-stdio --test https://your-server.example.com:8080/mcp
+```
 ## Claude Desktop の設定
 `claude_desktop_config.json` に追加：
@@ -118,7 +143,7 @@ mcp-stdio [OPTIONS] URL
   --oauth                OAuth 2.1 認証を有効化
   --client-id ID         事前登録済み OAuth クライアント ID（MCP_OAUTH_CLIENT_ID 環境変数でも指定可）
   --oauth-scope SCOPE    要求する OAuth スコープ
-  -H 'Key: Value'        カスタムヘッダー（複数指定可）
+  -H, --header 'Key: Value'  カスタムヘッダー（複数指定可）
   --timeout-connect SEC  接続タイムアウト（デフォルト: 10秒）
   --timeout-read SEC     読み取りタイムアウト（デフォルト: 120秒）
   --test                 接続テストして終了
@@ -126,7 +151,7 @@ mcp-stdio [OPTIONS] URL
   -h, --help             ヘルプ表示
 ```
-## ユースケース
+## ワークアラウンド
 Claude Code の HTTP transport の既知の問題を回避できます：
@@ -134,26 +159,8 @@ Claude Code の HTTP transport の既知の問題を回避できます：
 - **Accept ヘッダーの欠落** — サーバーが 406 を返し、認証エラーと誤認される（[#42470](https://github.com/anthropics/claude-code/issues/42470)）
 - **OAuth フォールバックループ** — OAuth 不要なサーバーでも OAuth 検出が走る（[#34008](https://github.com/anthropics/claude-code/issues/34008), [#39271](https://github.com/anthropics/claude-code/issues/39271)）
 - **切断後にセッションが失われる** — mcp-stdio は 404 で MCP セッションを自動回復（[#34498](https://github.com/anthropics/claude-code/issues/34498), [#38631](https://github.com/anthropics/claude-code/issues/38631)）
-- **プロキシ設定が無視される** — Claude Code が `NO_PROXY` を尊重しない（[#34804](https://github.com/anthropics/claude-code/issues/34804)）; mcp-stdio は httpx 経由でプロキシ設定を��承
-## 機能
-- **OAuth 2.1 クライアント** — 認可コードフロー（PKCE）、動的クライアント登録、トークンリフレッシュ、安全なトークン永続化を内蔵。MCP 認可仕様の関連 RFC に完全対応：
-  - [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728) Protected Resource Metadata の検出
-  - [RFC 8414](https://www.rfc-editor.org/rfc/rfc8414) Authorization Server Metadata の検出
-  - [RFC 8707](https://www.rfc-editor.org/rfc/rfc8707) Resource Indicators によるオーディエンス指定
-  - [RFC 7636](https://www.rfc-editor.org/rfc/rfc7636) PKCE（S256 チャレンジメソッド）
-  - [RFC 7591](https://www.rfc-editor.org/rfc/rfc7591) Dynamic Client Registration
-  - [RFC 6750](https://www.rfc-editor.org/rfc/rfc6750) Bearer Token の利用
-- **バックオフ付きリトライ** — 接続エラー時に最大3回リトライ
-- **ストリーミング耐性** — SSE レスポンスをリアルタイムで転送、切断時にリトライ
-- **セッション回復** — 404 でセッション ID をリセットして再試行
-- **401 時の自動トークンリフレッシュ** — セッション中に OAuth トークンが失効しても自動更新
-- **Bearer token 認証** — `--bearer-token` フラグまたは `MCP_BEARER_TOKEN` 環境変数
-- **カスタムヘッダー** — `-H` で任意のヘッダーを送信
-- **グレースフルシャットダウン** — SIGTERM/SIGINT ハンドリング
-- **プロキシ対応** — `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` 環境変数を [httpx](https://www.python-httpx.org/) 経由でサポート
-- **最小依存** — [httpx](https://www.python-httpx.org/) のみ; OAuth は stdlib のみ使用
+- **OAuth scope が送信されない** — 認可リクエストに `scope` パラメータが含まれず、厳格な OAuth サーバーがフローを拒否する（[#4540](https://github.com/anthropics/claude-code/issues/4540)）; mcp-stdio は `--oauth-scope` でスコープを送信
+- **プロキシ設定が無視される** — Claude Code が `NO_PROXY` を尊重しない（[#34804](https://github.com/anthropics/claude-code/issues/34804)）; mcp-stdio は httpx 経由でプロキシ設定を継承
 ## 仕組み

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/README.md RENAMED Viewed

@@ -4,11 +4,11 @@
 English | [日本語](README.ja.md)
-Stdio-to-HTTP relay for MCP servers — bridges Claude Desktop/Code to remote Streamable HTTP endpoints.
+Stdio-to-HTTP relay — bridges MCP clients to remote HTTP MCP servers.
-## Why?
+## Overview
-[MCP](https://modelcontextprotocol.io/) clients like Claude Desktop and Claude Code see mcp-stdio as a locally running self-hosted MCP server, while it relays all requests to a remote MCP server over Streamable HTTP:
+[MCP](https://modelcontextprotocol.io/) clients like Claude Desktop and Claude Code see mcp-stdio as a locally running self-hosted MCP server, while it relays all requests to a remote MCP server with support for various authentication methods:
 ```mermaid
 flowchart BT
@@ -21,6 +21,25 @@ flowchart BT
 Bearer tokens, custom headers, and OAuth 2.1 credentials are forwarded to the remote server.
+## Features
+- **OAuth 2.1 client** — built-in authorization code flow with PKCE, dynamic client registration, token refresh, and secure token persistence. Implements the full MCP authorization spec:
+  - [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728) Protected Resource Metadata discovery
+  - [RFC 8414](https://www.rfc-editor.org/rfc/rfc8414) Authorization Server Metadata discovery
+  - [RFC 8707](https://www.rfc-editor.org/rfc/rfc8707) Resource Indicators for audience binding
+  - [RFC 7636](https://www.rfc-editor.org/rfc/rfc7636) PKCE with S256 challenge method
+  - [RFC 7591](https://www.rfc-editor.org/rfc/rfc7591) Dynamic Client Registration
+  - [RFC 6750](https://www.rfc-editor.org/rfc/rfc6750) Bearer Token usage
+- **Retry with backoff** — retries up to 3 times on connection errors
+- **Streaming resilience** — streams SSE responses in real time; retries on mid-stream disconnect
+- **Session recovery** — resets MCP session ID on 404 and retries
+- **Token refresh on 401** — automatically refreshes expired OAuth tokens mid-session
+- **Bearer token auth** — via `--bearer-token` flag or `MCP_BEARER_TOKEN` env var
+- **Custom headers** — pass any header with `-H`
+- **Graceful shutdown** — handles SIGTERM/SIGINT
+- **Proxy support** — respects `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` env vars via [httpx](https://www.python-httpx.org/)
+- **Minimal dependencies** — only [httpx](https://www.python-httpx.org/); OAuth uses stdlib only
 ## Install
 ```bash
@@ -64,7 +83,7 @@ mcp-stdio https://your-server.example.com:8080/mcp --bearer-token YOUR_TOKEN
 With custom headers:
 ```bash
-mcp-stdio https://your-server.example.com:8080/mcp -H "X-API-Key: YOUR_KEY"
+mcp-stdio https://your-server.example.com:8080/mcp --header "X-API-Key: YOUR_KEY"
 ```
 With OAuth 2.1 authentication (for servers that require it):
@@ -76,6 +95,12 @@ mcp-stdio --oauth https://your-server.example.com:8080/mcp
 mcp-stdio --oauth --client-id YOUR_CLIENT_ID https://your-server.example.com:8080/mcp
 ```
+Test connectivity before use:
+```bash
+mcp-stdio --test https://your-server.example.com:8080/mcp
+```
 ## Claude Desktop Configuration
 Add to `claude_desktop_config.json`:
@@ -120,7 +145,7 @@ Options:
   --oauth                Enable OAuth 2.1 authentication
   --client-id ID         Pre-registered OAuth client ID (or set MCP_OAUTH_CLIENT_ID)
   --oauth-scope SCOPE    OAuth scope to request
-  -H 'Key: Value'        Custom header (can be repeated)
+  -H, --header 'Key: Value'  Custom header (can be repeated)
   --timeout-connect SEC  Connection timeout (default: 10)
   --timeout-read SEC     Read timeout (default: 120)
   --test                 Test connection and exit
@@ -128,7 +153,7 @@ Options:
   -h, --help             Show help
 ```
-## Use Cases
+## Workarounds
 Works around known issues in Claude Code's HTTP transport:
@@ -136,27 +161,9 @@ Works around known issues in Claude Code's HTTP transport:
 - **Missing Accept header** — servers return 406, misinterpreted as auth failure ([#42470](https://github.com/anthropics/claude-code/issues/42470))
 - **OAuth fallback loop** — Claude Code enters OAuth discovery even when not needed ([#34008](https://github.com/anthropics/claude-code/issues/34008), [#39271](https://github.com/anthropics/claude-code/issues/39271))
 - **Session lost after disconnect** — mcp-stdio recovers MCP sessions automatically on 404 ([#34498](https://github.com/anthropics/claude-code/issues/34498), [#38631](https://github.com/anthropics/claude-code/issues/38631))
+- **OAuth scope omitted** — Claude Code sends no `scope` parameter in authorization requests, causing strict OAuth servers to reject the flow ([#4540](https://github.com/anthropics/claude-code/issues/4540)); mcp-stdio sends scopes via `--oauth-scope`
 - **Proxy settings ignored** — Claude Code does not respect `NO_PROXY` ([#34804](https://github.com/anthropics/claude-code/issues/34804)); mcp-stdio inherits proxy settings from httpx
-## Features
-- **OAuth 2.1 client** — built-in authorization code flow with PKCE, dynamic client registration, token refresh, and secure token persistence. Implements the full MCP authorization spec:
-  - [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728) Protected Resource Metadata discovery
-  - [RFC 8414](https://www.rfc-editor.org/rfc/rfc8414) Authorization Server Metadata discovery
-  - [RFC 8707](https://www.rfc-editor.org/rfc/rfc8707) Resource Indicators for audience binding
-  - [RFC 7636](https://www.rfc-editor.org/rfc/rfc7636) PKCE with S256 challenge method
-  - [RFC 7591](https://www.rfc-editor.org/rfc/rfc7591) Dynamic Client Registration
-  - [RFC 6750](https://www.rfc-editor.org/rfc/rfc6750) Bearer Token usage
-- **Retry with backoff** — retries up to 3 times on connection errors
-- **Streaming resilience** — streams SSE responses in real time; retries on mid-stream disconnect
-- **Session recovery** — resets MCP session ID on 404 and retries
-- **Token refresh on 401** — automatically refreshes expired OAuth tokens mid-session
-- **Bearer token auth** — via `--bearer-token` flag or `MCP_BEARER_TOKEN` env var
-- **Custom headers** — pass any header with `-H`
-- **Graceful shutdown** — handles SIGTERM/SIGINT
-- **Proxy support** — respects `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` env vars via [httpx](https://www.python-httpx.org/)
-- **Minimal dependencies** — only [httpx](https://www.python-httpx.org/); OAuth uses stdlib only
 ## How It Works
 1. If `--oauth` is set, obtains an access token (cached → refresh → browser flow)

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/pyproject.toml RENAMED Viewed

@@ -1,12 +1,12 @@
 [project]
 name = "mcp-stdio"
 dynamic = ["version"]
-description = "Stdio-to-HTTP relay for MCP servers"
+description = "Stdio-to-HTTP relay — bridges MCP clients to remote HTTP MCP servers"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
 authors = [{ name = "Shigechika AIKAWA" }]
-keywords = ["mcp", "stdio", "proxy", "relay", "claude"]
+keywords = ["mcp", "stdio", "proxy", "relay", "claude", "bridge", "oauth"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Environment :: Console",
@@ -14,7 +14,9 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries",
 ]

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/server.json RENAMED Viewed

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.shigechika/mcp-stdio",
   "title": "MCP Stdio",
-  "description": "Stdio-to-HTTP relay for MCP servers",
+  "description": "Stdio-to-HTTP relay — bridges MCP clients to remote HTTP MCP servers",
   "repository": {
     "url": "https://github.com/shigechika/mcp-stdio",
     "source": "github"

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/src/mcp_stdio/__init__.py RENAMED Viewed

@@ -1,3 +1,3 @@
 """mcp-stdio: Stdio-to-HTTP relay for MCP servers."""
-__version__ = "0.3.2"
+__version__ = "0.3.4"

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/src/mcp_stdio/cli.py RENAMED Viewed

@@ -11,7 +11,7 @@ from typing import Callable
 import httpx
 from . import __version__
-from .relay import log, run, test_connection
+from .relay import check_connection, log, run
 def _parse_header(header: str) -> tuple[str, str]:
@@ -194,7 +194,7 @@ def main() -> None:
             client.close()
     if args.test:
-        ok = test_connection(
+        ok = check_connection(
             url=args.url,
             headers=headers,
             timeout_connect=args.timeout_connect,

{mcp_stdio-0.3.2 → mcp_stdio-0.3.4}/src/mcp_stdio/relay.py RENAMED Viewed

@@ -10,6 +10,8 @@ from typing import Any
 import httpx
+from mcp_stdio import __version__
 MAX_RETRIES = 3
 RETRY_DELAY = 1  # seconds
@@ -99,14 +101,74 @@ def _post_and_stream(
     return None
-def test_connection(
+def _reinitialize(
+    client: httpx.Client,
+    url: str,
+    headers: dict[str, str],
+) -> str | None:
+    """Send an initialize handshake to establish a new MCP session.
+    Used to recover after a session expires (server returns 404 on the
+    next request). Performs the full MCP initialize handshake:
+    1. POST an ``initialize`` request to get a new session ID
+    2. POST a ``notifications/initialized`` notification to signal
+       readiness (required by the MCP spec before any other requests)
+    Returns the new session ID on success, or None on failure. The
+    initialize response payload is discarded — the caller only needs
+    the session ID for subsequent requests.
+    """
+    initialize_msg = json.dumps(
+        {
+            "jsonrpc": "2.0",
+            "method": "initialize",
+            "id": 0,
+            "params": {
+                "protocolVersion": "2024-11-05",
+                "capabilities": {},
+                "clientInfo": {"name": "mcp-stdio", "version": __version__},
+            },
+        }
+    )
+    try:
+        resp = client.post(url, content=initialize_msg, headers=headers)
+    except httpx.HTTPError as e:
+        log(f"re-initialize request failed: {e}")
+        return None
+    if resp.status_code != 200:
+        log(f"re-initialize returned HTTP {resp.status_code}")
+        return None
+    new_session_id = resp.headers.get("mcp-session-id")
+    if not new_session_id:
+        log("re-initialize response missing mcp-session-id header")
+        return None
+    # MCP spec: send notifications/initialized before any other requests
+    initialized_msg = json.dumps(
+        {"jsonrpc": "2.0", "method": "notifications/initialized"}
+    )
+    initialized_headers = dict(headers)
+    initialized_headers["Mcp-Session-Id"] = new_session_id
+    try:
+        resp = client.post(url, content=initialized_msg, headers=initialized_headers)
+    except httpx.HTTPError as e:
+        log(f"notifications/initialized failed: {e}")
+        return None
+    if resp.status_code not in (200, 202):
+        log(f"notifications/initialized returned HTTP {resp.status_code}")
+        return None
+    return new_session_id
+def check_connection(
     url: str,
     headers: dict[str, str],
     *,
     timeout_connect: float = 10,
     timeout_read: float = 120,
 ) -> bool:
-    """Test MCP server connectivity by sending an initialize request.
+    """Check MCP server connectivity by sending an initialize request.
     Returns True if the server responds successfully.
     """
@@ -118,15 +180,13 @@ def test_connection(
             "params": {
                 "protocolVersion": "2024-11-05",
                 "capabilities": {},
-                "clientInfo": {"name": "mcp-stdio", "version": "test"},
+                "clientInfo": {"name": "mcp-stdio", "version": __version__},
             },
         }
     )
     client = httpx.Client(
-        timeout=httpx.Timeout(
-            connect=timeout_connect, read=timeout_read, write=30, pool=10
-        )
+        timeout=httpx.Timeout(connect=timeout_connect, read=timeout_read, write=30, pool=10)
     )
     try:
@@ -169,9 +229,7 @@ def test_connection(
             tools = "yes" if caps.get("tools") else "no"
             resources = "yes" if caps.get("resources") else "no"
             prompts = "yes" if caps.get("prompts") else "no"
-            log(
-                f"✓ Capabilities: tools={tools}, resources={resources}, prompts={prompts}"
-            )
+            log(f"✓ Capabilities: tools={tools}, resources={resources}, prompts={prompts}")
         elif result_data and "error" in result_data:
             err = result_data["error"]
             log(f"✗ MCP error: {err.get('message', err)}")
@@ -273,11 +331,18 @@ def run(
                     )
                     continue
-            # Session expired (404) — reset and retry once
+            # Session expired (404) — reset, re-initialize, then retry
             if result.status_code == 404 and session_id:
-                log("session expired, resetting and retrying")
+                log("session expired, re-initializing and retrying")
                 session_id = None
+                new_session_id = _reinitialize(client, url, dict(headers))
+                if new_session_id is None:
+                    log("re-initialize failed, dropping request")
+                    print(_error_response("session lost", req_id), flush=True)
+                    continue
+                session_id = new_session_id
                 req_headers = dict(headers)
+                req_headers["Mcp-Session-Id"] = session_id
                 result = _post_and_stream(client, url, line, req_headers, req_id)
                 if result is None:
                     continue

mcp-stdio 0.3.2__tar.gz → 0.3.4__tar.gz

mcp-stdio 0.3.2tar.gz → 0.3.4tar.gz