Colab MCP Server を Web サーバーとして公開し、PWA クライアントから CMS を構成する手法

Google Colab 上の MCP Server を Streamable HTTP 対応の Web サービスとしてトンネリング公開し、Progressive Web App(PWA)クライアントからコンテンツ管理システム(CMS)を構築する完全ガイド。

最終更新: 2026年9月8日

1

全体アーキテクチャ

本手法は、Google Colab の一時的な実行環境を「ヘッドレス CMS バックエンド」として位置づけ、PWA クライアントから Model Context Protocol(MCP)を介してコンテンツを管理する構成です。公式の googlecolab/colab-mcp は stdio トランスポートを前提したローカルエージェント向け設計であるため、PWA から直接利用するには HTTP / SSE / Streamable HTTP 対応の MCP Server を Colab 上に新規構築(またはラップ)する必要があります。

┌─────────────────┐ ┌─────────────────────────────┐ ┌─────────────────┐ │ PWA (Client) │ ◄─────► │ Public URL (ngrok etc.) │ ◄─────► │ Google Colab │ │ - React/Vue │ HTTP │ - Streamable HTTP / SSE │ Tunnel │ - FastAPI │ │ - ServiceWorker│ MCP │ - CORS enabled │ │ - MCP Server │ │ - IndexedDB │ │ - Bearer/OAuth auth │ │ - CMS Tools │ └─────────────────┘ └─────────────────────────────┘ │ - Google Drive │ │ (persistence) │ └─────────────────┘
ポイント
Colab のセッションは一時的ですが、記事データを Google Drive に JSON 形式で永続化することで、セッション切断後もデータを保持できます。MCP の Streamable HTTP トランスポートにより、PWA は標準的な HTTP 通信でサーバーとやり取りできます。
2

バックエンド: Colab 上の MCP Web サーバー

2.1 必要なライブラリ

Colab ノートブックのセルで以下を実行し、FastAPI と FastMCP、トンネリング用の pyngrok をインストールします。

# Colab セルで実行
!pip install fastapi uvicorn fastmcp pyngrok

2.2 FastAPI + FastMCP で Streamable HTTP Server を構築

fastmcp と FastAPI を組み合わせ、MCP Server を Web アプリとしてマウントします。以下は、記事の CRUD とメディア管理を備えた CMS ツールを定義した完全な実装例です。

from fastapi import FastAPI, Depends, HTTPException, Header
from fastapi.middleware.cors import CORSMiddleware
from fastmcp import FastMCP
from fastmcp.integrations.fastapi import mount_mcp
import uvicorn
import json
import os
from datetime import datetime
from google.colab import drive

# Google Drive をマウント(永続化用)
drive.mount('/content/drive')
CMS_DIR = "/content/drive/MyDrive/cms_data"
os.makedirs(CMS_DIR, exist_ok=True)

app = FastAPI(title="Colab CMS MCP Server")

# CORS: PWA からのアクセスを許可
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],  # 本番では PWA のドメインのみに制限
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

# MCP Server 定義
mcp = FastMCP("ColabCMS")

# ========================
# CMS Tools (MCP)
# ========================

@mcp.tool()
def list_posts() -> str:
    """記事一覧を取得"""
    posts = []
    for fname in os.listdir(CMS_DIR):
        if fname.endswith(".json"):
            with open(os.path.join(CMS_DIR, fname), "r") as f:
                posts.append(json.load(f))
    return json.dumps(sorted(posts, key=lambda x: x.get("updated", ""), reverse=True))

@mcp.tool()
def get_post(slug: str) -> str:
    """指定スラッグの記事を取得"""
    path = os.path.join(CMS_DIR, f"{slug}.json")
    if not os.path.exists(path):
        return json.dumps({"error": "not_found"})
    with open(path, "r") as f:
        return json.dumps(json.load(f))

@mcp.tool()
def create_post(slug: str, title: str, content: str, tags: list = None) -> str:
    """新規記事を作成"""
    path = os.path.join(CMS_DIR, f"{slug}.json")
    if os.path.exists(path):
        return json.dumps({"error": "already_exists"})
    data = {
        "slug": slug,
        "title": title,
        "content": content,
        "tags": tags or [],
        "created": datetime.now().isoformat(),
        "updated": datetime.now().isoformat(),
    }
    with open(path, "w") as f:
        json.dump(data, f, ensure_ascii=False)
    return json.dumps({"status": "created", "slug": slug})

@mcp.tool()
def update_post(slug: str, title: str = None, content: str = None, tags: list = None) -> str:
    """記事を更新"""
    path = os.path.join(CMS_DIR, f"{slug}.json")
    if not os.path.exists(path):
        return json.dumps({"error": "not_found"})
    with open(path, "r") as f:
        data = json.load(f)
    if title:   data["title"] = title
    if content: data["content"] = content
    if tags:    data["tags"] = tags
    data["updated"] = datetime.now().isoformat()
    with open(path, "w") as f:
        json.dump(data, f, ensure_ascii=False)
    return json.dumps({"status": "updated", "slug": slug})

@mcp.tool()
def delete_post(slug: str) -> str:
    """記事を削除"""
    path = os.path.join(CMS_DIR, f"{slug}.json")
    if os.path.exists(path):
        os.remove(path)
        return json.dumps({"status": "deleted", "slug": slug})
    return json.dumps({"error": "not_found"})

@mcp.tool()
def list_media() -> str:
    """アップロード済みメディア一覧"""
    media_dir = os.path.join(CMS_DIR, "media")
    os.makedirs(media_dir, exist_ok=True)
    return json.dumps(os.listdir(media_dir))

# FastAPI に MCP をマウント (Streamable HTTP)
mount_mcp(app, mcp, path="/mcp")

@app.get("/")
def root():
    return {"message": "Colab CMS MCP Server is running"}

2.3 実装のポイント

項目内容
永続化Colab のセッションは一時的なので、記事データは Google Drive に JSON 形式で保存
ランスポートmount_mcp で Streamable HTTP(POST/GET + SSE)を有効化。PWA から直接 MCP プロトコルで通信可能
公開pyngrok で localhost:8000 をインターネット公開。PWA はこの HTTPS URL に接続
認証必要に応じて Authorization ヘッダーを検証する Depends を /mcp やツール内に追加
3

公開: Colab サーバーをインターネットに出す

3.1 ngrok での公開(最も簡単)

2023年以降、ngrok の無料アカウントにも 1つの static dev domain(例: xxx.ngrok-free.dev)が割り当てられます。セッションを再起動しても URL が変わらないため、PWA 側のエンドポイントを固定できます。

from pyngrok import ngrok

# 自分の static domain を指定(ダッシュボードで確認可能)
public_url = ngrok.connect(
    addr="8000",
    proto="http",
    domain="your-domain.ngrok-free.dev"  # 無料で割り当てられたドメイン
)
print(public_url)  # https://your-domain.ngrok-free.app/mcp で常にアクセス可能
ngrok 無料版の制約
データ転送は約 1GB/月、リクエスト数は約 2万/月、HTTP/S エンドポイントにインタースティシャル広告ページが入ることがあります。

3.2 Cloudflare Tunnel(cloudflared)での公開

ngrok よりも安定しており、挿入告ページがありません。Colab 上で cloudflared を使う方法が広く使われています。

# cloudflared のダウンロードとインストール
!wget -q https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -O cloudflared
!chmod +x cloudflared

# FastAPI サーバーをバックグラウンドで起動
!nohup uvicorn server:app --host 0.0.0.0 --port 8000 > server.log 2>&1 &

# Cloudflare Tunnel で公開(ランダム一時URL)
!./cloudflared tunnel --url http://localhost:8000

出力された https://abc123.trycloudflare.com/mcp を PWA 側の MCP_URL に設定します。

3.3 公開手法の比較

比較項目ngrokCloudflare Tunnel
無料固定ドメイン1つ(*.ngrok-free.dev)カスタムドメイン紐付け可能
挿入広告ページあり(無料版)なし
セットアップ難易度簡単(pyngrok 1行)やや手順が多い
速度・安定性良好非常に良好
Colab 相性良好良好
4

フロントエンド: PWA からの接続

4.1 SDK のインストール

PWA 側は公式の TypeScript SDK(@modelcontextprotocol/sdk)を使い、StreamableHTTPClientTransport で接続します。

npm install @modelcontextprotocol/sdk

4.2 MCP クライアンの実装

// mcp-client.ts
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk";

const MCP_URL = "https://xxxx.ngrok-free.app/mcp"; // Colab で発行された URL

let client: Client | null = null;

export async function connectMCP() {
  const transport = new StreamableHTTPClientTransport(new URL(MCP_URL));

  client = new Client({ name: "pwa-cms-client", version: "1.0.0" });
  await client.connect(transport);

  // ツール一覧を取得(CMS 機能の発見)
  const tools = await client.listTools();
  console.log("Available tools:", tools);
  return client;
}

// CMS 操作ラッパー
export async function listPosts() {
  if (!client) throw new Error("Not connected");
  const result = await client.callTool("list_posts", {});
  return JSON.parse(result.content[0].text);
}

export async function getPost(slug: string) {
  if (!client) throw new Error("Not connected");
  const result = await client.callTool("get_post", { slug });
  return JSON.parse(result.content[0].text);
}

export async function createPost(
  slug: string, title: string, content: string, tags?: string[]
) {
  if (!client) throw new Error("Not connected");
  const result = await client.callTool("create_post", { slug, title, content, tags });
  return JSON.parse(result.content[0].text);
}

export async function updatePost(
  slug: string,
  updates: { title?: string; content?: string; tags?: string[] }
) {
  if (!client) throw new Error("Not connected");
  const result = await client.callTool("update_post", { slug, ...updates });
  return JSON.parse(result.content[0].text);
}

export async function deletePost(slug: string) {
  if (!client) throw new Error("Not connected");
  const result = await client.callTool("delete_post", { slug });
  return JSON.parse(result.content[0].text);
}

4.3 PWA の構成例(React)

// App.tsx
import { useEffect, useState } from "react";
import { connectMCP, listPosts, createPost } from "./mcp-client";

export default function App() {
  const [posts, setPosts] = useState<any[]>([]);
  const [connected, setConnected] = useState(false);

  useEffect(() => {
    connectMCP().then(() => {
      setConnected(true);
      refresh();
    });
  }, []);

  async function refresh() {
    const data = await listPosts();
    setPosts(data);
  }

  return (
    <div className="p-4">
      <h1>Colab CMS PWA</h1>
      <p>Status: {connected ? "Connected" : "Connecting..."}</p>
      <button onClick={refresh}>Refresh</button>
      <ul>
        {posts.map((p) => (
          <li key={p.slug}>{p.title}</li>
        ))}
      </ul>
    </div>
  );
}

4.4 PWA 化のポイント

5

セキュリティ: 公開時の必須対策

5.1 Bearer Token 認証

公開 URL は全世界に晒されるため、/mcp エンドポイントに Bearer Token 認証を適用します。

from fastapi import Depends, HTTPException, Header

API_TOKEN = os.environ.get("MCP_AUTH_TOKEN", "change-me-in-production")

def verify_token(authorization: str = Header(None)):
    if not authorization or not authorization.startswith("Bearer "):
        raise HTTPException(status_code=401, detail="Missing or invalid token")
    token = authorization.replace("Bearer ", "")
    if token != API_TOKEN:
        raise HTTPException(status_code=403, detail="Invalid token")
    return token

# MCP エンドポイントに認証を適用
mount_mcp(app, mcp, path="/mcp", dependencies=[Depends(verify_token)])

PWA 側では、トランスポートの初期化時にヘッダーを渡します。

const transport = new StreamableHTTPClientTransport(
  new URL(MCP_URL),
  { headers: { Authorization: `Bearer ${API_TOKEN}` } }
);

5.2 CORS の厳格化

本番環境では allow_origins=["*"] を避け、PWA のドメインのみを許可します。

app.add_middleware(
    CORSMiddleware,
    allow_origins=["https://your-pwa-domain.vercel.app"],
    allow_credentials=True,
    allow_methods=["POST", "GET", "OPTIONS"],
    allow_headers=["Authorization", "Content-Type", "mcp-session-id"],
)
6

運用の注意点と本番移行

6.1 Colab 特有の制約

リスク対策
セッション切断無料版はアイドル 90分・最大 12時間で切断。ブラウザ keep-alive スクリプトや Colab Pro のバックグラウンド実行で緩和
ngrok URL の変動無料版でも固定ドメイン 1つが利用可能。固定が必須なら有料版または Cloudflare Tunnel のカスタムドメインを検討
データ転送上限ngrok 無料版は 1GB/月。CMS 利用なら十分だが、メディア配信には不向き
認証・認可公開 URL になった時点で誰でもアクセス可能。Bearer Token または MCP の OAuth 2.1 拡張を必ず実装
重要
「常時運用の本番サーバー」として Colab を使うのは推奨されません。プロトイプ・個人利用・短時間デモ向けです。本格的な CMS 公開には、以下の永続ホスティングサービスへの移行を検討してください。

6.2 本番移行先

HF Hugging Face Spaces

MCP Server としての Spaces デプロイを公式にサポート。Streamable HTTP 対応の MCP Server を無料でホスト可能。requirements.txt + app.py で即デプロイ。

Rd Render

Web Service として Docker または Native Python 環境で動作。自動 HTTPS、環境変数管理が組み込み。セッション切断なしで常時運用可能。

6.3 公開手法の選択まとめ

用途推奨手法理由
数時間のデモ・検証ngrok(固定ドメイン)1行で公開、PWA の URL を固定できる
広告なし・安定接続Cloudflare Tunnel無料で挿入ページなし、速度良好
個人 CMS(非商用)Colab + Tunnel + Drive無料 GPU/CPU + 無料ストレージ
本番・常時運用Hugging Face Spaces / Renderセッション切断なし、常時 SSL、カスタムドメイン対応
7

まとめ

Colab MCP Server を Web サーバーとして公開し、PWA クライアントから CMS を構成するには、「FastAPI + FastMCP(Streamable HTTP)+ ngrok / Cloudflare Tunnel」という構成が最も現実的です。

この手法により、AI エージェント向けプロトコルである MCP を「Web アプリとサーバーの通信規約」として転用し、軽量なヘッドレス CMS を Colab の無料環境上に構築できます。ただし、Colab のセッション寿命という制約を理解したうえで、本番運用には Hugging Face Spaces や Render への移行を視野に入れることが重要です。

← Archives