自然言語で ActiveRecord を操作する試み

Stdio の MCP Server を使って自然言語で ActiveRecord を操作してレコードを取得する試みについてのスライドです

Transcript

1. 2025/10/06 【リジェクトConライク】Re:cycle〜Kaigi on Rails 2025編〜 株式会社タイミー 神山大智 自然言語で ActiveRecord を操作する試み @_dak2_
2. 自己紹介 Daichi Kamiyama (@dak2) • 株式会社タイミー(2024年6月入社) • バックエンドエンジニア ◦ 働き手であるワーカーの時間と事業者の時間のマッチング部 分を最適化するための改善や機能開発に従事 ◦ 最近は生成AIに対して丁寧にお伺いすることを生業にしてい るが、生成AIのアウトプットをレビューする認知負荷の高さに 疲弊している
3. 今日伝えたいこと 自然言語で ActiveRecord は 操作できる！！ *1 *1 本番環境で検証できてないです
4. 目次 • 動機の話 • MCP との出会い • MCP サーバーを作る • 自然言語でクエリしよう
5. ある日思ったんですよね
6. 自然言語でレコード を参照できると嬉しそう
7. rails c とか rails runner で取得して コピペしたら良いよね
8. 値を取得するために 都度クエリを叩かないと
9. 面倒だネ！
10. MCP を使えば なんとかできるんじゃない？
11. そもそも MCP って何？
12. AI アプリケーションと外部システム を繋ぐ機構のこと https://modelcontextprotocol.io/docs/getting-started/intro
14. AI エージェントが Google カレンダー とか Notion にアクセスして、パーソナ ライズされたレスポンスを返せる
15. MCP のユースケースって 何があるの？
16. https://github.com/modelcontextprotocol/servers
17. modelcontextprotocol/servers に MCP Server の実例、いわゆる “Real World MCP” が掲載されています
18. • Heroku • Notion • Prisma • TiDB • AWS, Azure, Google Cloud Run, etc…
19. MCP のユースケース 増えていってる
20. 9/23 に chrome-dev-tools MCP が発 表されました ブラウザのコンソールログやネットワークログを取得したり、スクリーンショッ トを撮影したりすることで、デバッグ情報を AI エージェントに提供できるみた いです。便利そう https://developer.chrome.com/blog/chrome-devtools-mcp?hl=ja
21. データベース周りの MCP は どんなものがある？
22. https://github.com/googleapis/genai-toolbox
23. https://github.com/pingcap/pytidb
24. https://github.com/aliyun/alibabacloud-adb-mysql-mcp-server
25. https://github.com/niledatabase/nile-mcp-server
26. MCP でデータベースと接続する ユースケースはありそう
27. MCP 経由でデータベース見に行かなく ても、Rails の ActiveRecord を介して 見に行った方が早そう （接続時の認証まわり面倒そうですし）
28. ActiveRecord を介してレコードを取得 する MCP サーバーを作ろう
29. MCP サーバーを 自作していく
30. gem あるかな？
31. • fast-mcp ◦ 割と機能が揃ってる • mcp-rb ◦ Sinatra like の DSL でシンプルに書ける • ruby-sdk ◦ MCP の Ruby 公式 SDK
32. 複雑なものを 作るわけではないので拘りがない => 公式を使っておこう
33. 前提 • 生成 AI の GUI は Claude Desktop ◦ => Client • MCP サーバーは stdio • GUI から Rails プロジェクトのレコー ドを取得する
34. 補足 MCP サーバーには • stdio ◦ 標準入出力なのでプロセスとして動かす • Streamable HTTP ◦ HTTP POST/GET を通じてやり取り
35. Let’s building
36. https://github.com/modelcontextprotocol/ruby-sdk/tree/main/examples 1. 実現方法を確認
37. https://github.com/modelcontextprotocol/ruby-sdk/blob/main/examples/stdio_server.rb 1. 実現方法を確認
38. とてもシンプルな構成で、Tool 定義し て stdio サーバーを立ち上げる 1. 実現方法を確認
39. ここで道筋の整理 🛤 • ActiveRecord を介してレコードを取 得できる Tool を定義 • Stdio Server に定義した Tool を設定 • 標準入出力として呼び出し • Claude Desktop と連携 1. 実現方法を確認
40. https://github.com/modelcontextprotocol/ruby-sdk/blob/main/examples/stdio_server.rb 2. Tool を定義
41. https://github.com/dak2/activerecord-mcp/blob/main/lib/activerecord-mcp/tools/select_records.rb 2. Tool を定義
42. https://github.com/dak2/activerecord-mcp/blob/main/lib/activerecord-mcp/tools/select_records.rb 2. Tool を定義
43. https://github.com/dak2/activerecord-mcp/blob/main/lib/activerecord-mcp/tools/select_records.rb 2. Tool を定義
44. Open3#capture3 を使って別ディ レクトリの Rails アプリケーション で ActiveRecord を実行する 2. Tool を定義
45. 少し Open3 の説明
46. https://docs.ruby-lang.org/en/3.4/Open3.html#method-i-capture3 2-1. Open3
47. https://docs.ruby-lang.org/en/3.4/Open3.html#method-c-popen3 2-1. Open3
48. ActiveRecord を実行する別の Rails ア プリケーションのディレクトリを指定 する必要がある 2-1. Open3
49. https://docs.ruby-lang.org/en/3.4/Process.html#method-c-spawn 2-1. Open3
50. https://github.com/dak2/activerecord-mcp/blob/main/lib/activerecord-mcp/tools/select_re cords.rb 2-1. Open3
51. 2-1. Open3 つまり、 大いなる力を使う ということです
52. https://github.com/dak2/activerecord-mcp/blob/main/exe/activerecord-mcp 3. Stdio MCP Server の立ち上げ設定
53. exe ディレクトリに定義した Stdio MCP Server をクライアント側、つまり Claude Desktop から呼んでもらう 3. Stdio MCP Server の立ち上げ設定
54. ~/Library/Application Support/Claude/claude_desktop_config.json 4. Claude Desktop と繋ぎ込み
55. 別の Rails アプリケーションと言及して いましたが、posts だけのテーブルを 持った rails new に毛が生えた程度のア プリで実験してます 補足
56. デモ
57. 注意事項
58. • SQL 文はちゃんと検証した方が良い • 本番環境で試していないです ◦ できると便利そうではある。ちょっと怖いけど • 認証周り(Authorization)未対応です • かなり力技の実装になってると思いますw
59. まとめ
60. • 自然言語でクエリできる MCP サーバーも サクッと作れる • Open3 は用法用量を守って使った方が良 さそう • modelcontextprotocol/servers 見ると 様々なユースケースがあるので見てみると 面白い