MakiAi commited on
Commit
caf810b
·
verified ·
1 Parent(s): 8608413

Update app.py

Browse files
Files changed (1) hide show
  1. app.py +50 -18
app.py CHANGED
@@ -143,10 +143,12 @@ with gr.Blocks(
143
  このアプリは、Gradio の新しい **Streamable HTTP Transport for MCP server** 機能のデモです。
144
 
145
  ## 🔗 ライブ MCP エンドポイント
146
- 以下のエンドポイントで実際にMCPツールにアクセスできます:
147
  - **HTTP Transport**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/`
148
  - **SSE Transport**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/sse`
149
 
 
 
150
  ## 🛠️ 利用可能なツール
151
  """)
152
 
@@ -243,24 +245,40 @@ with gr.Blocks(
243
  gr.Markdown("""
244
  ## 📋 MCP クライアントでの使用方法
245
 
246
- ### 🧪 **MCP Inspector でテスト**
 
 
247
  ```bash
248
  npx @modelcontextprotocol/inspector https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/
249
  ```
250
 
251
- ### 🖥️ **Claude Desktop での設定例**
252
- ```json
253
- {
254
- "mcpServers": {
255
- "gradio-mcp-demo": {
256
- "command": "npx",
257
- "args": [
258
- "@modelcontextprotocol/server-everything",
259
- "https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/"
260
- ]
261
- }
262
- }
263
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
264
  ```
265
 
266
  ### 🛠️ **利用可能なツール**
@@ -271,20 +289,34 @@ with gr.Blocks(
271
  ## 🔧 技術詳細
272
 
273
  - **🌐 Space URL**: [Hugging Face Space](https://huggingface.co/spaces/MakiAi/gradio-streamable-mcp-demo)
274
- - **🚀 Transport**: Streamable HTTP (最新機能!)
275
  - **📡 Protocol**: MCP (Model Context Protocol)
276
  - **🔗 HTTP Endpoint**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/`
277
  - **📺 SSE Endpoint**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/sse`
278
  - **✨ Features**: ファイル入出力対応、リアルタイム処理、状態管理
279
 
280
- ## 🎯 デモの特徴
281
 
282
  このアプリは **Gradio PR #11300** で実装された最新の Streamable HTTP Transport 機能を使用しています。
283
- 従来のSSE(Server-Sent Events)に加えて、より効率的なHTTP通信でMCPツールを利用できます。
 
 
 
 
 
 
 
 
 
 
 
 
 
284
 
285
  **🔗 関連リンク**:
286
  - [Original PR #11300](https://github.com/gradio-app/gradio/pull/11300)
287
  - [MCP Protocol](https://modelcontextprotocol.io/)
 
288
  - [Gradio MCP Documentation](https://gradio.app/docs/mcp)
289
  """)
290
 
 
143
  このアプリは、Gradio の新しい **Streamable HTTP Transport for MCP server** 機能のデモです。
144
 
145
  ## 🔗 ライブ MCP エンドポイント
146
+ 以下のエンドポイントで**MCP Inspector**や対応クライアントからMCPツールにアクセスできます:
147
  - **HTTP Transport**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/`
148
  - **SSE Transport**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/sse`
149
 
150
+ **⚠️ 注意**: Claude Desktop は現在 HTTP transport に対応していません。MCP Inspector での動作確認をお勧めします。
151
+
152
  ## 🛠️ 利用可能なツール
153
  """)
154
 
 
245
  gr.Markdown("""
246
  ## 📋 MCP クライアントでの使用方法
247
 
248
+ ### 🧪 **動作確認済みの方法**
249
+
250
+ **✅ MCP Inspector(最推奨)**:
251
  ```bash
252
  npx @modelcontextprotocol/inspector https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/
253
  ```
254
 
255
+ **✅ cURL でのテスト**:
256
+ ```bash
257
+ curl -X POST https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/ \
258
+ -H "Content-Type: application/json" \
259
+ -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'
260
+ ```
261
+
262
+ ### 🖥️ **Claude Desktop での制限と代替手段**
263
+
264
+ **⚠️ 重要**: Claude Desktop は現在 HTTP transport を直接サポートしていません。STDIO transport のみがサポートされています。
265
+
266
+ **🔧 代替解決策**:
267
+
268
+ **1. MCP Inspector での直接テスト(推奨)**:
269
+ ```bash
270
+ npx @modelcontextprotocol/inspector https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/
271
+ ```
272
+
273
+ **2. 他のMCPクライアントでの使用**:
274
+ - **Cursor IDE**: HTTP transport をサポート
275
+ - **LibreChat**: HTTP transport をサポート
276
+ - **VSCode 拡張**: 各種MCP拡張で利用可能
277
+
278
+ **3. STDIO-HTTP Proxy を使用**:
279
+ ```bash
280
+ # proxy サーバーを作成してClaude Desktopで使用
281
+ # 詳細: https://github.com/boilingdata/mcp-server-and-gw
282
  ```
283
 
284
  ### 🛠️ **利用可能なツール**
 
289
  ## 🔧 技術詳細
290
 
291
  - **🌐 Space URL**: [Hugging Face Space](https://huggingface.co/spaces/MakiAi/gradio-streamable-mcp-demo)
292
+ - **🚀 Transport**: Streamable HTTP (**最新機能!**)
293
  - **📡 Protocol**: MCP (Model Context Protocol)
294
  - **🔗 HTTP Endpoint**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/http/`
295
  - **📺 SSE Endpoint**: `https://makiai-gradio-streamable-mcp-demo.hf.space/gradio_api/mcp/sse`
296
  - **✨ Features**: ファイル入出力対応、リアルタイム処理、状態管理
297
 
298
+ ## 🎯 デモの特徴と現在の対応状況
299
 
300
  このアプリは **Gradio PR #11300** で実装された最新の Streamable HTTP Transport 機能を使用しています。
301
+
302
+ **✅ 動作確認済み**:
303
+ - MCP Inspector での直接アクセス
304
+ - Cursor IDE での HTTP transport
305
+ - LibreChat での HTTP transport
306
+ - cURL/HTTPクライアントでの直接API呼び出し
307
+
308
+ **⚠️ 制限事項**:
309
+ - Claude Desktop は現在 STDIO transport のみサポート
310
+ - HTTP transport は Claude Desktop で直接使用不可
311
+
312
+ **🔮 今後の展望**:
313
+ - Claude Desktop での HTTP transport サポート予定
314
+ - より多くのMCPクライアントでの対応拡大
315
 
316
  **🔗 関連リンク**:
317
  - [Original PR #11300](https://github.com/gradio-app/gradio/pull/11300)
318
  - [MCP Protocol](https://modelcontextprotocol.io/)
319
+ - [MCP Community Discussion](https://github.com/orgs/modelcontextprotocol/discussions/16)
320
  - [Gradio MCP Documentation](https://gradio.app/docs/mcp)
321
  """)
322