symfony/mcp-bundleで、既存アプリケーションもお手軽にMCPサーバー化

PHPカンファレンス香川2025でのLT資料です
https://fortee.jp/phpconkagawa-2025/proposal/984674a8-deb8-48e5-aa02-285dd423c50b

Transcript

1. symfony/mcp-bundleで、 既存アプリケーションも お手軽にMCPサーバー化 PHPカンファレンス香川2025(前夜祭LT) Hideki Kinjyo GitHub: o0h / X: @o0h_ [発表用] v1.0.2
2. こんにちは、AIエージェントです
3. こんにちは、AIエージェントです
4. 猫も杓子もMCP
5. 俺たちWebプログラマー
6. 作るの得意な Web app
7. (まるでWeb Appを作るように) MCPサーバーを自由に、作りたいな
8. 皆さん大好きSymfony
9. はい、symfony/mcp-bundle〜
10. 調べてみましょう そして、知りましょう
15. そんなものは無いってマ！？ (デマだった？！)
16. でも大丈夫 みんなの不安を払拭するデモ
17. ・・に入る前に(そろそろ真面目に) こんな話をします: Webアプリケーションとして開発したコードが、 簡単にMCPサーバーとして機能する
18. (そろそろ真面目に) 話し方: 1. まずは「Webアプリケーション」のデモを見て、 その次に「MCPサーバー」のデモを見せます 2. その後に、「実際のコードの比較」とか 「symfony/mcp-bundleってどういうもの？」って話をします
19. 自己紹介 • 金城秀樹 / きんじょうひでき • GitHub: @o0h / 𝕏 : @o0h_ • 好きなFWはCakePHP • アイコンは美味しい鮭親子丼の写真です • 最近はPodcastをやっています • ハッシュタグ: #readlinefm 
20. デモ / PUNK SIMPLE CMS
22. デモ / mcp:simple-cms
30. コードの紹介 (ここまでに2分くらいで
31. Web App • 何の変哲もない チュートリアルレベルの コントローラー • CRUDをサポートしている
32. 「Content」リソース用のController #[Route('/content')] class ContentController extends AbstractController { public function __construct( private ContentService $contentService, ) { コンストラクタで 「サービス」を注入 ※ 依存解決はFWの標準的なモノ
33. list #[Route('/', name: 'content_index', methods:['GET'])] public function index(): Response { $contents = $this ->contentService ->listLatest(); return $this->render( 'content/index.html.twig', ['contents' => $contents] ); }
34. list #[Route('/', name: 'content_index', methods:['GET'])] public function index(): Response { $contents = $this ->contentService ->listLatest(); return $this->render( 'content/index.html.twig', ['contents' => $contents] ); } $contents = $this ->contentService ->listLatest(); 「サービス」に生やした機能に 処理は丸投げ
35. list #[Route('/', name: 'content_index', methods:['GET'])] public function index(): Response { $contents = $this ->contentService ->listLatest(); return $this->render( 'content/index.html.twig', ['contents' => $contents] ); } ['contents' => $contents] 「サービス」から受け取った オブジェクトを Viewにそのまま引き渡す
36. add #[Route('/new', name:'content_create', methods:['POST'])] public function create( #[MapRequestPayload] ContentInput $input, ): Response { $this->contentService->create($input); $this->addFlash( 'success', 'Content created successfully', ); return $this->redirectToRoute('content_index'); }
37. add #[Route('/new', name:'content_create', methods:['POST'])] public function create( #[MapRequestPayload] ContentInput $input, ): Response { $this->contentService->create($input); $this->addFlash( 'success', 'Content created successfully', ); return $this->redirectToRoute('content_index'); } #[MapRequestPayload] ContentInput $input, FWの機能で リクエスト内容が オブジェクトに自動変換されて メソッドに入ってくる
38. add #[Route('/new', name:'content_create', methods:['POST'])] public function create( #[MapRequestPayload] ContentInput $input, ): Response { $this->contentService->create($input); $this->addFlash( 'success', 'Content created successfully', ); return $this->redirectToRoute('content_index'); } $this->contentService->create($input); $inputを そのまま「サービス」に丸投げ
39. これを「MCPサーバーで使える」にするコード
40. 「Content Tools」用のクラス final class ContentTools { public function __construct( private ContentService $contentService, private ValidatorInterface $validator, ) { コンストラクタで 必要な依存を注入 ※ 依存解決はFWの標準的なモノ
41. list #[McpTool( name: 'list_contents', description: 'ίϯςϯπҰཡΛ࠷৽ॱͰऔಘ͠·͢', )] public function listContents(): array { return $this->contentService->listLatest(); }
42. list ★中身はま〜〜〜〜ったく同じと言えるレベル！ public function listContents(): array { return $this->contentService->listLatest(); public function index(): Response { $contents = $this->contentService->listLatest(); return $this->render( Controller Tool用クラス
43. list #[McpTool( name: 'list_contents', description: 'ίϯςϯπҰཡΛ࠷৽ॱͰऔಘ͠·͢', )] public function listContents(): array { return $this->contentService->listLatest(); } #[McpTool( name: 'list_contents', description: 'ίϯςϯπҰཡΛ࠷৽ॱͰऔಘ͠·͢', )] Attributesが重要
44. #[McpTool( name: 'list_contents', description: 'ίϯςϯπҰཡΛ࠷৽ॱͰऔಘ͠·͢', )] list ★Attributeの引数がそのまま渡されて、MCPツールが喋る内容になる
45. #[\McpTool] は何を返せばいいか ★一例として、「JSONにできるモノ(orその配列)」を返すだけでOK /** * @return list<Content> */ public function listContents(): array class Content implements \JsonSerializable {
46. add #[McpTool( name: 'create_content', description: '৽͍͠ίϯςϯπΛ࡞੒͠·͢', )] public function createContent( string $title, string $body, string $status, ?string $publishedAt = null, ): Content {
47. add #[McpTool( name: 'create_content', description: '৽͍͠ίϯςϯπΛ࡞੒͠·͢', )] public function createContent( string $title, string $body, string $status, ?string $publishedAt = null, ): Content { string $title, string $body, string $status, ?string $publishedAt = null, メソッドの引数を自動的に解釈して MCPサーバーとして 喋ってくれる ※PHPDocがあればそれも
48. add // public function createContent { $input = new ContentInput( $title, $body, $status, $publishedAt ? new \DateTimeImmutable($publishedAt) : null, ); $this->validateInput($input); return $this->contentService- >create($input); } 中身は 何の変哲も無いコード
49. symfony/mcp-bundleとは？ (ここまでに3分半くらいで
50. こんなbundle ここまでに触れた機能の殆どは、実は「mcp/sdk(公式PHP SDK)」のモノ • #[McpTool]Attributeも • ※他に、リソースやプロンプトのためのAttributeも提供されている • それが付いたメソッドを読み取ってToolsに登録するのも • なんだったら、MCPサーバーの「サーバー機能」もmcp/sdkの機能
51. こんなbundle 逆に言えば、FW非依存でこのくらいの事はできるとも言える • 例えばCakePHPの実践例 https://www.cakedc.com/jorge_gonzalez/2025/11/07/cakephp-ai- integration-build-a-cakephp-mcp-server-with-claude
52. mcp/sdk (modelcontextprotocol/php-sdk) • PHP FoundationやSymfonyチームも噛んでいる • 詳しい話はThe PHP Foundationのブログに • https://thephp.foundation/blog/2025/09/05/php-mcp-sdk/ • mcp-bundleも公式SDKの公開にあわせて乗り換えた経緯 • [MCP Bundle] Adopt official MCP SDK · Issue #526 · symfony/ai https://github.com/symfony/ai/issues/526 • PSR-11(Container I/F)を採用していて便利
53. symfony/mcpは何をしているの？ • Symfonyとのより高い結合を行っている • DI周り、コマンドの提供、ロガー設定など • とりわけ「依存の解決手段を整えて、SDK側に渡す」のは重要 • これがあるので、「FWに乗った普段のアプリが即MCPサーバーに」が実現される
54. 実際、 symfonu/mcp-bundleの Commandクラスの実装は これだけ
55. \Mcp\Server::run()を 実行しているだけ
56. コンストラクタで \Mcp\Server::run()に DIコンテナをセットした状態で 渡している なので「MCPサーバーのTools」で Symfonyアプリケーションの サービスが普段通り使える
57. MCPサーバーとは?
58. MCPαʔόʔͱ͸? Model Context Protocol ͷجૅ MCPͱ͸ AIΞϓϦέʔγϣϯ͕σʔλιʔε΍πʔϧʹ઀ଓ͢ΔͨΊͷඪ४ϓϩτίϧ ͳͥඞཁͳͷ͔ ैདྷ͸ΞϓϦ͝ͱʹಠࣗͷ౷߹ํ๏͕ඞཁ͕ͩͬͨɺMCPʹΑͬͯҰ౓࡞Ε͹ɺͲͷMCPରԠAIΞϓϦ͔Β΋ ར༻Մೳʹ ओͳϝϦοτ ౷߹ͷ؆ૉԽ | ࠶ར༻ੑͷ޲্ | ඪ४ԽʹΑΔ։ൃޮ཰Ξοϓ MCP Server ͷҙٛͱ࣮૷ཁ݅
59. MCPαʔόʔͷ࢓૊Έ ௨৴ํࣜ • stdio (ඪ४ೖग़ྗ) • SSE (Server-Sent Events) ඞਢػೳ • initialize - ઀ଓཱ֬ • tools/list - πʔϧҰཡ • tools/call - πʔϧ࣮ߦ جຊతͳྲྀΕ AIΞϓϦ → MCPαʔόʔ: tools/list Ͱπʔϧऔಘ AIΞϓϦ → MCPαʔόʔ: tools/call Ͱπʔϧ࣮ߦ MCPαʔόʔ → AIΞϓϦ: ࣮ߦ݁ՌΛฦ٫ MCP Server ͷҙٛͱ࣮૷ཁ݅
60. ࣮૷ཁ݅ͱ·ͱΊ ࠷খݶͷ࣮૷ • αʔόʔͷىಈॲཧ (stdio ·ͨ͸ SSE) • initialize ϋϯυϥʔ • tools/list ϋϯυϥʔ • tools/call ϋϯυϥʔ MCPαʔόʔ = AI͕֎෦πʔϧɾσʔλʹΞΫηε͢ΔͨΊͷඪ४తͳڮ౉͠໾ MCP Server ͷҙٛͱ࣮૷ཁ݅
61. まとめ
62. LTお疲れ様でした • symfony/mcp-bundleを使うと、 「いつものアプリケーション」を簡単にMCPサーバー化できる • 特に複雑な部分はmcp/sdkが担ってくれているので、 他のFWでもサクッと行けそう • まだstableリリースがないので、いつ使えるかは慎重に判断 • 気楽に触れて面白いので、遊んでみましょう！
63. おしまい！ お付き合いいただき ありがとうございました!!