たった 1 枚の PHP ファイルで実装する MCP サーバ / MCP Server with Vanilla PHP

2025/06/28 開催の「PHP Conference Japan 2025」（https://phpcon.php.gr.jp/2025/ ）の LT 資料です。

詳細：https://fortee.jp/phpcon-2025/proposal/d85fb877-e734-43a4-a529-9aea783eeea5

Transcript

1. たった 1 枚の PHP ファイルで実装する MCP サーバ 2025-06-28 PHP Conference Japan 2025
2. MCP、使ってますか？
3. • Model Context Protocol • LLM アプリケーションが外部のシステム等と やりとりをする際のプロトコル • Claude を提供している Anthropic 社が提唱 MCP とは
4. LLM は"尤もらしい続き"を返すことしかできない LLM LLM アプリケー ション 今日の東京の天気は？ ユーザーが 「今日の東京の天気は？」 と聞いています。
5. LLM は"尤もらしい続き"を返すことしかできない LLM LLM アプリケー ション 今日の東京の天気は？ ユーザーが 「今日の東京の天気は？」 と聞いています。 2025 年の天気は提供できません。 2025 年の天気は提供できません。
6. 外界とのやりとりはアプリケーションの役割 LLM LLM アプリケー ション 今日の東京の天気は？ ツールとして 天気情報システムが使えます。 ユーザーが 「今日の東京の天気は？」 と聞いています。 天気情報 システム
7. 外界とのやりとりはアプリケーションの役割 LLM LLM アプリケー ション 今日の東京の天気は？ ツールとして 天気情報システムが使えます。 ユーザーが 「今日の東京の天気は？」 と聞いています。 天気情報システムに 2025 年 6 月 28 日の東京の天気を問い合わせま す。 天気情報 システム 2025-06-28, 東京 晴れ
8. 外界とのやりとりはアプリケーションの役割 LLM LLM アプリケー ション 今日の東京の天気は？ ツールとして 天気情報システムが使えます。 ユーザーが 「今日の東京の天気は？」 と聞いています。 天気情報システムに 2025 年 6 月 28 日の東京の天気を問い合わせま す。 天気情報 システム 2025-06-28, 東京 晴れ
9. MCP を使わずに連携する場合 各 LLM アプリケーションと MCP の関係 : : Claude Desktop Copilot Chat Gemini CLI
10. MCP で連携する場合 各 LLM アプリケーションと MCP の関係 MCP MCP Client MCP Client MCP Client MCP Server MCP Server : : Claude Desktop Copilot Chat Gemini CLI 1 種類のサーバで複数種のクライアントに対応できる
11. PSR cf.) PHP における FW と PSR の関係 Logger DI Container : 1 種類の実装を複数の FW から利用できる :
12. • 外部のシステム等とやりとりをするために 必ず MCP が必要、というわけではない • あくまで 1 企業が提唱したプロトコルに過ぎない • 連携のために各 LLM アプリケーションが独自で 仕組みを実装したってよい 知っておくとよいこと
13. 時は 2025 年 3 月 26 日
14. MCP の新バージョン ※現時点の最新は 2025-06-18
15. MCP サーバを HTTP で実装可能に Streamable HTTP transport https://github.com/modelcontextprotocol/modelcontextprotocol/pull/206
16. PHPer のメインフィールドですね？ そう、つまり
17. と、いうわけで
18. 実装したものがこちら https://github.com/okashoi/mcp-streamable-http-server-with-vanilla-php
19. Composer 未使用 = Web アプリケーション FW や 　MCP SDK などを一切使わない 　素 PHP のみ 実装したものがこちら <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } 約 100 行
20. 実装の解説
21. せっかく PHP で実装するなら PHP である意味 を持たせたい......
22. PHP が持っている最高に便利な関数 https://www.php.net/manual/ja/function.date-sun-info.php
23. PHP が持っている最高に便利な関数 https://www.php.net/manual/ja/function.date-sun-info.php 今回は日の出時刻の情報を提供する tool を考える
24. MCP サーバ（Streamable HTTP Transport）の仕様 • 受け取るのは /mcp への POST のみ • やりとりするデータは JSON RPC 2.0 に準拠 最小限のMCP サーバを実装するために • 1 つの tool（日の出時刻）だけを提供 • 4 種類の処理を実装するだけで OK • 入力値の検証やエラーハンドリング等は行わない 実装説明
25. MCP サーバ（Streamable HTTP Transport）の仕様 • 受け取るのは /mcp への POST のみ • やりとりするデータは JSON RPC 2.0 に準拠 最小限のMCP サーバを実装するために • 1 つの tool（日の出時刻）だけを提供 • 4 種類の処理を実装するだけで OK • 入力値の検証やエラーハンドリング等は行わない 実装説明
26. <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } 実装説明 - リクエストハンドリング HTTPメソッドの検証などはしない。 なぜなら最小限だから。 ※真似する場合は自己責任で
27. MCP サーバ（Streamable HTTP Transport）の仕様 • 受け取るのは /mcp への POST のみ • やりとりするデータは JSON RPC 2.0 に準拠 最小限のMCP サーバを実装するために • 1 つの tool（日の出時刻）だけを提供 • 4 種類の処理を実装するだけで OK • 入力値の検証やエラーハンドリング等は行わない 実装説明
28. JSON-RPC 2.0 { jsonrpc: "2.0"; id: string | number; method: string; params?: { [key: string]: unknown; }; } { jsonrpc: "2.0"; id: string | number; result?: { [key: string]: unknown; } error?: { code: number; message: string; data?: unknown; } } Request Response Notifications は今回使わないので省略
29. <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } 実装説明 - JSON RPC リクエストのパース $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); json_decode は必ず成功するものとする。 なぜなら最小限だから。
30. 実装説明 - JSON RPC レスポンス <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); $parsedBody には必ず id が存在するものとする。 なぜなら最小限だから。
31. MCP サーバ（Streamable HTTP Transport）の仕様 • 受け取るのは /mcp への POST のみ • やりとりするデータは JSON RPC 2.0 に準拠 最小限のMCP サーバを実装するために • 1 つの tool（日の出時刻）だけを提供 • 4 種類の処理を実装するだけで OK • 入力値の検証やエラーハンドリング等は行わない 実装説明
32. 実装説明 <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry
33. 実装説明 <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry 固定値を返すだけ
34. 実装説明 - initialize <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry
35. 実装説明 - initialize function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; }
36. 実装説明 - initialize function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } tool のみを提供
37. 実装説明 - initialize function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } 変更を通知しない
38. 実装説明 - notifications/initialized <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry クライアントの初期化が成功したら送られてくる
39. 実装説明 - tools/list <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry 利用可能なツールの情報を提供
40. function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], // （中略） ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } 実装説明 - tools/list
41. function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], // （中略） ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } 実装説明 - tools/list
42. 実装説明 - tools/call <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry
43. 実装説明 - tools/call <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; $parsedBody は常に正しい形式であるとする。 なぜなら最小限（ry 今回 tool は 1種類だけ なので決め打ち
44. 実装説明 - tools/call - get_sunrise_time <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。 ', ]], 'isError' => true, ]; }
45. 実装説明 - tools/call - get_sunrise_time <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。 '; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。 '; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ];
46. Composer 未使用 = Web アプリケーション FW や 　MCP SDK などを一切使わない 　素 PHP のみ 実装説明、以上 <?php $requestBody = file_get_contents('php://input'); $parsedBody = json_decode($requestBody, true); $data = match ($parsedBody['method']) { 'initialize' => getInitialInfo(), 'notifications/initialized' => http_response_code(202) && exit(), 'tools/list' => listTools(), 'tools/call' => getSunriseTime( (float)$parsedBody['params']['arguments']['latitude'], (float)$parsedBody['params']['arguments']['longitude'], $parsedBody['params']['arguments']['date'] ?? null, ), }; header('Content-Type: application/json'); echo json_encode([ 'jsonrpc' => '2.0', 'id' => $parsedBody['id'], 'result' => $data, ]); exit(); function getInitialInfo(): array { return [ 'protocolVersion' => '2025-03-26', 'capabilities' => [ 'tools' => [ 'listChanged' => false, ], ], 'serverInfo' => [ 'name' => 'date sun info server', 'version' => '1.0.0', ], ]; } function listTools(): array { return [ 'tools' => [ [ 'name' => 'get_sunrise_time', 'description' => '与えらた地点の緯度経度と日付から、その地点の日の出時刻をUTCで取得します。', 'inputSchema' => [ 'type' => 'object', 'properties' => [ 'latitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の北緯。南緯は負の値で表します。', ], 'longitude' => [ 'type' => 'number', 'description' => '日の出時刻を知りたい地点の東経。西経は負の値で表します。', ], 'date' => [ 'type' => 'string', 'description' => '日の出時刻を知りたい日付。YYYY-MM-DD形式で指定します。デフォルトは今日の日付です。', ], ], 'required' => ['latitude', 'longitude'], ], ], ], ]; } function getSunriseTime(float $latitude, float $longitude, ?string $date = null): array { $timestamp = $date ? strtotime($date) : time(); if ($timestamp === false) { return [ 'content' => [[ 'type' => 'text', 'text' => '日付の形式が不正です。', ]], 'isError' => true, ]; } $sunriseTime = date_sun_info($timestamp, $latitude, $longitude)['sunrise']; if ($sunriseTime === false) { $text = '1日中日が昇りません（極夜）。'; } else if ($sunriseTime === true) { $text = '1日中日が昇ったままです（白夜）。'; } else { $text = '日の出時刻は' . date('H:i', $sunriseTime) . '（UTC）です。'; } return [ 'content' => [[ 'type' => 'text', 'text' => $text, ]], 'isError' => false, ]; } 約 100 行
47. 実際に使ってみる （GitHub Copilot Chat / VSCode）
48. MCP サーバの起動
49. MCP サーバの登録 { "servers": { "date-sun-info": { "url": "http://localhost/mcp" } } } .vscode/mcp.json
50. MCP サーバの登録
51. 実際に使ってみる
52. 実際に使ってみる
53. 実際に使ってみる
54. 実際に使ってみる
55. 実際に使ってみる
57. 詳細な仕様は公式のドキュメントをチェック https://modelcontextprotocol.io/specification
58. 詳細な仕様は公式のドキュメントをチェック https://github.com/modelcontextprotocol/modelcontextprotocol/tree/main/schema
59. ちなみに
60. MCP サーバなしで同じ質問をした場合
61. MCP サーバなしで同じ質問をした場合
62. MCP サーバなしで同じ質問をした場合 実際には「それを MCP サーバにする必要があるか？」 をちゃんと考えましょう
63. 所属：株式会社リンケージ 登壇： 寄稿： 岡田 正平／おかしょい X: @okashoi GitHub: @okashoi