全体アーキテクチャ
本手法は、Google Colab の一時的な実行環境を「ヘッドレス CMS バックエンド」として位置づけ、PWA クライアントから Model Context Protocol(MCP)を介してコンテンツを管理する構成です。公式の googlecolab/colab-mcp は stdio トランスポートを前提したローカルエージェント向け設計であるため、PWA から直接利用するには HTTP / SSE / Streamable HTTP 対応の MCP Server を Colab 上に新規構築(またはラップ)する必要があります。
バックエンド: 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 やツール内に追加 |
公開: 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 で常にアクセス可能
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 公開手法の比較
| 比較項目 | ngrok | Cloudflare Tunnel |
|---|---|---|
| 無料固定ドメイン | 1つ(*.ngrok-free.dev) | カスタムドメイン紐付け可能 |
| 挿入広告ページ | あり(無料版) | なし |
| セットアップ難易度 | 簡単(pyngrok 1行) | やや手順が多い |
| 速度・安定性 | 良好 | 非常に良好 |
| Colab 相性 | 良好 | 良好 |
フロントエンド: 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 化のポイント
- manifest.json: アプリ名、アイコン、テーマカラーを設定
- Service Worker: 記事のキャッシュ、オフライン閲覧を実現(IndexedDB や Cache API を併用)
- HTTPS 必須: ngrok / Cloudflare Tunnel は自動的に HTTPS を提供するめ、PWA 要件を満たします
セキュリティ: 公開時の必須対策
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.1 Colab 特有の制約
| リスク | 対策 |
|---|---|
| セッション切断 | 無料版はアイドル 90分・最大 12時間で切断。ブラウザ keep-alive スクリプトや Colab Pro のバックグラウンド実行で緩和 |
| ngrok URL の変動 | 無料版でも固定ドメイン 1つが利用可能。固定が必須なら有料版または Cloudflare Tunnel のカスタムドメインを検討 |
| データ転送上限 | ngrok 無料版は 1GB/月。CMS 利用なら十分だが、メディア配信には不向き |
| 認証・認可 | 公開 URL になった時点で誰でもアクセス可能。Bearer Token または MCP の OAuth 2.1 拡張を必ず実装 |
6.2 本番移行先
MCP Server としての Spaces デプロイを公式にサポート。Streamable HTTP 対応の MCP Server を無料でホスト可能。requirements.txt + app.py で即デプロイ。
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、カスタムドメイン対応 |
まとめ
Colab MCP Server を Web サーバーとして公開し、PWA クライアントから CMS を構成するには、「FastAPI + FastMCP(Streamable HTTP)+ ngrok / Cloudflare Tunnel」という構成が最も現実的です。
- バックエンド: Colab 上で FastAPI を起動し、
fastmcpのツールとして CMS 機能(記事 CRUD、メディア管理)を実装。Google Drive でータを永続化します。 - 通信:
mount_mcpにより/mcpエンドポイントが Streamable HTTP 対応になり、PWA から直接 MCP プロトコルで呼び出せます。 - フロントエンド: PWA 側は
@modelcontextprotocol/sdkのStreamableHTTPClientTransportを使用して接続し、ツール一覧の自動発見と実行を行います。
この手法により、AI エージェント向けプロトコルである MCP を「Web アプリとサーバーの通信規約」として転用し、軽量なヘッドレス CMS を Colab の無料環境上に構築できます。ただし、Colab のセッション寿命という制約を理解したうえで、本番運用には Hugging Face Spaces や Render への移行を視野に入れることが重要です。