commit

Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.10-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PORT=7860
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]

README1.md

@@ -0,0 +1,21 @@
+# FastMCP サンプル MCP サーバー (Hugging Face Spaces デプロイ用)
+FastMCP 2.12.4 を使った MCP サーバーのサンプルです。`app.py` では `Sample MCP Server` (version 0.1.0) を定義し、`/mcp` エンドポイントを Streamable HTTP で公開しています。`@mcp.tool` で登録した `echo` ツールを呼び出すと、受け取ったテキストをそのまま返します。Hugging Face Spaces に配置することで、ChatGPT などの MCP 対応クライアントから簡単に利用できます。
+## セットアップ
+- Python 3.10 以降を想定しています。
+- 仮想環境を作成したら、`pip install -r requirements.txt` を実行して FastMCP と Uvicorn をインストールしてください。
+## ローカル動作確認
+1. `python app.py` を実行すると、`http://localhost:7860` にサーバーが立ち上がります。`/` でヘルスチェック (`{"status": "ok", ...}`) を確認できます。
+2. クライアント検証には `python client.py --url http://localhost:7860/mcp` を使用します。`ping → list_tools → call_tool("echo")` の順に呼び出し、最初の `TextContent` を標準出力に表示します。
+## Hugging Face Spaces へのデプロイ
+1. Space を作成し、SDK を「Docker」、ランタイムを「Streamable HTTP」に設定します。
+2. このリポジトリをそのままアップロードします (既存の `Dockerfile` で `uvicorn app:app --host 0.0.0.0 --port 7860` が実行される前提です)。
+3. ビルド後、Space の URL `https://<your-space>.hf.space` が発行されます。Streamable HTTP の `/mcp` エンドポイントが外部に公開され、MCP クライアントからアクセス可能になります。
+必要に応じて README に上記 Streamable HTTP 前提であること、`Dockerfile` のコマンド (`uvicorn app:app`) が FastMCP サーバーに対応していることを追記してください。
+## サーバー仕様メモ
+- `/mcp` は HTTP ベースの MCP エンドポイントです (WebSocket ではありません)。
+- `@mcp.tool` を追加することで、任意のツールを拡張できます。例: `echo` ツールは `{"text": "..."}` を受け取り同じ内容を返します。
+- `/` は Starlette ベースのヘルスチェックを返し、Spaces の稼働監視に利用できます。
+## ChatGPT からの接続手順
+1. ChatGPT アプリの MCP サーバー設定に、新規エンドポイントとして `https://<your-space>.hf.space/mcp` を登録します。
+2. FastMCP のクライアント (例: `client.py`) で事前に疎通確認すると安心です。
+3. ChatGPT 側で接続後、`echo` ツールを呼び出すと、入力テキストがそのままレスポンスとして返ります。

app.py

@@ -0,0 +1,21 @@
+"""FastMCP sample MCP server implementation."""
+from fastmcp import FastMCP
+from starlette.responses import JSONResponse
+import uvicorn
+mcp = FastMCP(name="Sample MCP Server", version="0.1.0")
+@mcp.tool(name="echo")
+async def echo(text: str) -> str:
+    """Return the provided text unchanged."""
+    return text
+@mcp.custom_route("/", methods=["GET"])
+async def health_check(_request) -> JSONResponse:
+    """Basic health-check endpoint for Hugging Face Spaces."""
+    return JSONResponse(
+        {
+            "status": "ok",
+            "message": "Sample MCP server is running with FastMCP.",
+        }
+    )
+app = mcp.http_app()
+if __name__ == "__main__":
+    uvicorn.run("app:app", host="0.0.0.0", port=7860, reload=False)

clinet.py

@@ -0,0 +1,43 @@
+"""Utility client for validating the FastMCP sample server."""
+from __future__ import annotations
+import argparse
+import asyncio
+from typing import Any, Iterable, Optional
+from fastmcp import Client
+from fastmcp.types import TextContent
+def extract_first_text_block(content_blocks: Optional[Iterable[Any]]) -> Optional[str]:
+    """Return the first text block contained in the MCP tool response."""
+    if not content_blocks:
+        return None
+    for block in content_blocks:
+        if isinstance(block, TextContent):
+            return block.text
+    return None
+async def run(url: str) -> None:
+    """Execute a simple validation workflow against the MCP server."""
+    client = Client(url=url)
+    async with client:
+        ping_result = await client.ping()
+        print("Ping:", ping_result)
+        tools_response = await client.list_tools()
+        print("Tools:", tools_response)
+        tool_call = await client.call_tool("echo", {"text": "Hello MCP"})
+        text = extract_first_text_block(getattr(tool_call, "content", None))
+        if text is not None:
+            print("Echo response:", text)
+        else:
+            print("Echo response contains no TextContent blocks:", tool_call)
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="FastMCP sample client")
+    parser.add_argument(
+        "--url",
+        default="http://localhost:7860/mcp",
+        help="MCP server URL (default: %(default)s)",
+    )
+    return parser.parse_args()
+def main() -> None:
+    args = parse_args()
+    asyncio.run(run(args.url))
+if __name__ == "__main__":
+    main()
+

requirements.txt

@@ -0,0 +1,2 @@
+fastmcp==2.12.4
+uvicorn[standard]==0.30.1