もがき系プログラマの日常

もがき系エンジニアの勉強したこと、日常のこと、気になっている技術、備忘録などを紹介するブログです。

Laravel MCPで、ClaudeがToolを組み合わせて答えられるか試した

はじめに

こんばんは。

前回、Laravel MCP 1.0を触ってみた記事を書きました。

kojirooooocks.hatenablog.com

前回は、名前でユーザーを検索するToolを1つ作って、Claude Codeから呼んでみました。

次はToolを複数用意して、Toolを組み合わせて答えられるかを試してみました。

本題

準備

前回のデモプロジェクトに、検証用の解約日と問い合わせ履歴のデータと、検証用のToolを2つ足します。

Claude Codeで作ります。

このLaravelプロジェクトに、Laravel MCPのToolを追加してください。

準備
- usersテーブルに解約日(cancelled_at, nullable)を追加
- 問い合わせ履歴のinquiriesテーブルとInquiryモデルを追加(user_id, subject, created_at)
- Seederでダミーデータを作成。ユーザー30人程度、うち数人は先月(実行日の前月)に解約、
  数人はそれ以外の月に解約。問い合わせは1人あたり0〜5件をランダムに

Tool(app/Mcp/Tools に作成し、DemoServerの$toolsに登録)
- SearchCancelledUsersTool:期間(from, to)を指定して、その間に解約したユーザーを返す
- GetUserInquiriesTool:ユーザーIDを1つ指定して、そのユーザーの問い合わせ履歴を返す

ルール
- 既存のSearchUsersToolを参考に、use文は省略せずに書く
- どちらも #[IsReadOnly] と #[Description] を付ける
- 特定の質問に直接答えるToolは作らない。汎用的な部品にする

今回は検証用なので「特定の質問に直接答えるToolは作らない」という作りにしています。

マイグレーションとSeederの実行まで、全部やってくれました。データは、ユーザー31人(うち9月の解約5人、それ以外の月の解約5人)、問い合わせ67件です。

できたToolはこの2つです。

  • SearchCancelledUsersTool:from と to(YYYY-MM-DD)で、その期間に解約したユーザーを返す
  • GetUserInquiriesTool:user_id を1つ指定して、そのユーザーの問い合わせ履歴を返す

質問してみる

新しいToolを読み込ませるために、Claude Codeを起動し直してから聞きました。

demoのToolだけを使って答えてください。先月解約した人のうち、3回以上問い合わせしていた人は?

「demoのToolだけを使って」を付けているのは、プロジェクトの中で起動しているClaude Codeは、Toolを使わずに自分でSQLを叩いたりSeederを読んだりして答えられてしまうからです。

返ってきた答えはこれです。

demoのツールで調べたところ、先月(2026年9月)に解約した5人のうち、問い合わせが3回以上あったのは 2人 でした。

┌─────┬────────────────────┬────────────────────────────────┬────────────┬────────────────┐
│ ID  │        名前        │             メール             │   解約日   │ 問い合わせ件数 │
├─────┼────────────────────┼────────────────────────────────┼────────────┼────────────────┤
│ 24  │ Lisandro Buckridge │ landen.satterfield@example.org │ 2026-09-01 │ 5件            │
├─────┼────────────────────┼────────────────────────────────┼────────────┼────────────────┤
│ 25  │ Jack Will          │ amir.terry@example.net         │ 2026-09-05 │ 4件            │
└─────┴────────────────────┴────────────────────────────────┴────────────┴────────────────┘

問い合わせの内容
- Lisandro Buckridge:ログインできない、メールアドレスを変更したい、料金が高い、請求内容について、領収書の発行依頼(2025年9月〜2026年3月)
- Jack Will:不具合の報告、パスワードを再設定したい、請求内容について、メールアドレスを変更したい(2025年11月〜2026年9月)
  - 最後の問い合わせ(9/2)は解約日(9/5)の3日前です。

条件に当てはまらなかった3人は、Pedro Rohan(1件)、Camila Jakubowski(1件)、Grace Heidenreich(0件)です。

問い合わせ件数は、期間を絞らずに全期間で数えています。「解約前の◯か月以内」のように期間を区切る場合は、その条件で数え直します。

条件に当てはまらなかった3人の件数まで答えているので、解約ユーザーを検索したあと、5人全員分の問い合わせ履歴を1人ずつ取りに行っているのがわかります。

SQLで答え合わせ

本番の管理画面ならこう書く、という1本のSQLで正解を出して、比べてみました。

$ php artisan db
sqlite> SELECT u.id, u.name, u.cancelled_at, COUNT(i.id) AS inquiries
FROM users u
JOIN inquiries i ON i.user_id = u.id
WHERE u.cancelled_at >= '2026-09-01' AND u.cancelled_at < '2026-10-01'
GROUP BY u.id, u.name, u.cancelled_at
HAVING COUNT(i.id) >= 3;
24|Lisandro Buckridge|2026-09-01 21:57:08|5
25|Jack Will|2026-09-05 11:54:26|4

ID 24 が5件、ID 25 が4件で、Claude Codeの答えと一致しました。

AIが自分で判断していたところ

前回のユーザー検索は、条件も絞り込みもTool側のSQLが全部やっていて、AIは結果を伝えるだけでした。

今回は、Toolの外でAIが自分で判断している部分がありました。

  • 「先月」を、実行日から2026年9月と解釈して、解約ユーザーを検索していた
  • 解約ユーザーの一覧と問い合わせ履歴を、自分で突き合わせて件数を数えていた
  • 「件数は全期間で数えた。期間を区切るなら数え直す」と、自分の解釈をはっきり書いてきた

こういうイメージを補完してくれるのはいいところですよね。

終わりに

AIがToolを組み合わせて、正しく答えられることは確認できました。

大体のニュアンスで通じるのはいいですね。

現場からは以上です。