何が変わるか

ツールの中身は変わりません。変わるのは誰がプロセスを起こすかです。

載せ替える

samples/07-http/server.mjs の全文です。memo-tools.mjs はそのまま使います。

import { createServer } from 'node:http';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import { createMemoServer } from '../06-memo/memo-tools.mjs';

const PORT = Number(process.env.PORT ?? 3333);

const http = createServer(async (req, res) => {
	// MCP のエンドポイントは 1 つ。ここに POST が来る
	if (!req.url?.startsWith('/mcp')) {
		res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
		res.end('/mcp へ POST してください\n');
		return;
	}

	// セッションを持たない形。リクエストごとに使い捨てる
	const server = createMemoServer();
	const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });

	// 応答が終わったら片付ける。閉じ忘れると接続が溜まる
	res.on('close', () => {
		transport.close();
		server.close();
	});

	try {
		await server.connect(transport);
		await transport.handleRequest(req, res);
	} catch (err) {
		console.error('[http] 失敗:', err);
		if (!res.headersSent) {
			res.writeHead(500, { 'content-type': 'application/json' });
			res.end(JSON.stringify({
				jsonrpc: '2.0',
				error: { code: -32603, message: 'Internal server error' },
				id: null,
			}));
		}
	}
});

http.listen(PORT, () => {
	// stdio 版と違い、標準出力に書いても壊れない
	console.log(`メモサーバー（HTTP）: http://localhost:${PORT}/mcp`);
});

セッションを持つか

sessionIdGenerator をどうするかで、2 つの作りに分かれます。

メモサーバーは持たない側にしました。状態はファイルにあるので、リクエストごとに作り直しても困りません。

動かす

$env:PORT = "3333"
node docs/samples/07-http/server.mjs

メモサーバー（HTTP）: http://localhost:3333/mcp

叩いてみる

$body = '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"手","version":"1.0"}}}'

Invoke-WebRequest -Uri http://localhost:3333/mcp -Method Post `
	-Body $body -ContentType 'application/json' `
	-Headers @{ Accept = 'application/json, text/event-stream' } -UseBasicParsing

返ってきたものです。

HTTP 200
event: message
data: {"result":{"protocolVersion":"2025-11-25","capabilities":{...},"serverInfo":{"name":"memo","version":"1.0.0"}},"jsonrpc":"2.0","id":1}

Accept ヘッダを忘れない

これが最初の関門です。応答は「ただの JSON」か「SSE のストリーム」のどちらかで返ります。両方を受け取れると伝えないと、サーバーは断ります。

Accept: application/json, text/event-stream

SSE の形

SSE で返る場合、本文はこうなります。data: の後ろが JSON-RPC のメッセージです。

event: message
data: {"result":{...},"jsonrpc":"2.0","id":1}

手で解く場合はこう取り出します（10 章のブリッジで使います）。

function extractMessages(contentType, body) {
	if (contentType.includes('text/event-stream')) {
		return body.split('\n')
			.filter((line) => line.startsWith('data:'))
			.map((line) => line.slice(5).trim())
			.filter(Boolean);
	}
	return body.trim() ? [body.trim()] : [];
}

ホストに登録する

claude mcp add --transport http memo http://localhost:3333/mcp
codex mcp add memo --url http://localhost:3333/mcp

どちらを選ぶか

HTTP を選んだときに増える仕事

次の章へ

ここまでは「訊かれたら答える」だけでした。次はサーバーの側から伝える方法と、その限界を扱います。