Kotlin で始める MCP 入門

Kyoto.kt #3

Transcript

1. Kotlin で始める MCP 入門 id:rokuokun 2025/05/10 Kyoto.kt #3
2. About me (5.0s) • id:rokuokun / rokuosan / ろくお • Kotlin はいいなって思ってます。 • https://x.com/rokuosan_dev • AI ツールチェーン使いこなせてない • Kyoto.kt やっていき
3. 自然な導入 • 話題のMCPをやりたい • 実は全然触ってなくて時代遅れの人間だった • 公式 SDK に Kotlin がある！ • https://github.com/modelcontextprotocol/kotlin-sdk
4. 自分が知っている MCP • Model Context Protocol • Anthropic が去年の11月に突然言い出した。 • LLM がアプリケーションを操作するための プロトコル → インタフェースの置き換え
5. 自分が知っている MCP • Model Context Protocol • Anthropic が去年の11月に突然言い出した。 • LLM がアプリケーションを操作するための プロトコル → インタフェースの置き換えが起きる 若者としてコレはイカンでしょ
6. MCPのドキュメントを読む https://modelcontextprotocol.io/introduction
7. MCP Core Concepts (For Server) • Resources ◦ File-like data that can be read by clients (like API responses or file contents) • Tools ◦ Functions that can be called by the LLM (with user approval) • Prompts ◦ Pre-written templates that help users accomplish specific tasks
8. MCP Core Concepts をゆるく読むと • Resources ◦ URI でデータを表現して提供できる（OS API 以外にも Web API とかも呼べる） • Tools ◦ LLMから呼び出しできる関数 • Prompts ◦ プロンプトのテンプレートを記述できる
9. 感想と疑問 • これだけ読むと Resources は Tools として使えるのでは？ ◦ 通常の関数呼び出しのほか API 呼び出しもできる ◦ “事実上” Tools と同じ役割を果たすことができそう ◦ Tools は実行にユーザー承認が必要だが、Resources はそうでない ◦ つまり許可なしでなんでも実行できちゃう！？！？
10. Resources をよく読んでみる • そもそも LLM にコンテキストとして情報を渡す目的 • Resources は application-controlled（あるいは application-driven） ◦ ユーザーが「添付ファイル」としてLLMに投げるみたいなユースケース ◦ 例: MCP の最新の Specification をいつでもサッと取り出す ▪ https://modelcontextprotocol.io/llms-full.txt にアクセスして常に最新の spec を保った状態で質問ができる ▪ HTTP Scheme の場合、その URL にユーザーがアクセスできるべき(SHOULD) • LLM からではなく、人間からの呼び出しを想像すると良い
11. Resources 裏ワザ(?) • mcp 入門で UUID 作成する程度なら実は Resources でもできたりする ◦ Claude Desktop はResourceをキャッシュするわけじゃないので、 添付するごとにUUIDが更新される
12. Tools / JSON Schema https://modelcontextprotocol.io/docs/concepts/tools • データ構造は→ • annotation で メタデータ付与が できる openWorldHintが 個人的にいい名前で好き
13. なんとなくわかってきた
14. Kotlin の MCP SDK で実装をやってみる https://github.com/modelcontextprotocol/kotlin-sdk
15. Kotlin の MCP SDK 事情 • Kotlin 向け MCP 公式 SDK があるのでそれを使う • 元々 JetBrains が作っていたものを公式側に取り入れたぽい空気を感じる • https://github.com/modelcontextprotocol/kotlin-sdk • 対応 Transport ◦ Stdio (標準入出力) ◦ Server-Sent Event (SSE)
16. Streamable HTTP は未対応（2025/05/10時点） • 新しい Transport として Streamable HTTP が追加されたが... • 現在の Kotlin SDK (v0.5.0)では使えない • コントリビューションチャンスかと思ったらすでに取り組まれていた ◦ https://github.com/modelcontextprotocol/kotlin-sdk/pull/87 ◦ まだもう少しかかりそう
17. とりあえず書いてみる
18. UUID 生成 MCP サーバー • 雰囲気を知るにはちょうどいいって Twitter でみた • ちなみに Kotlin の UUID 事情 ◦ Kotlin 2.0 から標準 API に kotlin.uuid.Uuid が追加された ◦ まだ Experimental なので @OptIn(ExperimentalUuidApi::class) アノテーションが必須 ◦ UUIDv4 のみ生成可能 • 標準入出力と SSE の両方を試してみる
19. Server 部分 • MCP サーバの基礎部分は共通化できる ◦ Tools ◦ Resources ◦ Prompts • 変更通知の有無なども設定する
20. Tools の実装 Handler のラムダ→
21. Resources の実装 • さっき出したコード • URI は一意であれば良い。 ◦ http:// のものはユーザーからアクセス 可能なものである必要がある（仕様）
22. stdio Transport • 標準入力からもらってくる • MCP Server と Transport を繋げる • メインスレッドが落ちないようにする
23. Server-Sent Event Transport (1/2) • Ktor MCP Plugin を使うとこれだけで OK • embeddedServer を CIO をエンジンとして起動する • mcp {} では MCP Server のインスタンスを返すだけ
24. Server-Sent Event Transport (2/2) • 手書きするならこうやる • サンプルからとってきた
25. Claude Desktop / VSCode から使ってみる https://modelcontextprotocol.io/quickstart/user
26. MCP サーバを使うには？ • Claude Desktop • 自作 • VSCode ← NEW!
27. Claude Desktop で使ってみる • 温かみのある JSON 手書き • Settings > Developer をみる • 登録したら Restart • command は絶対パスにしておく • stdio しか対応していない？
28. Claude Desktop で使ってみる • 登録できるとこんな表示
29. Claude Desktop で使ってみる • 許可が求められて生成ができる
30. Claude ってもしかして... • アレ...？ • 最初に「UUIDを作成してください」 と言ったらそれらしい値が返ってきた • 騙されるところだった
31. VSCode で使ってみる • .vscode/mcp.json に書く。 • SSEもできるぞ！
32. VSCode で使ってみる • Claude Desktop に登録したもの も空気を読んで見てくれる • 失敗例↓
33. VSCode で使ってみる • 追加できている
34. 🎉
35. せっかくなので MCP Spec をいつでも出せるようにしてみる https://modelcontextprotocol.io/llms-full.txt
36. Resource から MCP Spec をとる • MCP の SDK に Ktor Client がある • 素直に fetch して値を返す
37. Resource から MCP Spec をとる • Claude Desktop でやってみる • できた • 無料枠だと長さ制限に達する
38. テストを書く
39. テスト方法 • 1. クライアントから実際に呼び出す • 2. Handler だけテスト • 3. Handler の中のロジックだけテスト 2, 3 やっておけばまぁ安心でしょ （クラアントも SDK で作れるので1もやれる）
40. テスト方法 / 2. Handler だけテスト • 雰囲気はこんな感じ
41. まとめ
42. MCP with Kotlin のまとめ • サンプルコードを見つつ実装した • 苦しさはない • 今後の主流になる Streamable HTTP は今後実装されるぽいので期待 • 割とサッとかけて嬉しい • Resources を使いこなすとインスタント NotebookLM ぽいことができる • MCP開発は思ったより快適にできる
43. Kotlin で始める MCP 入門 id:rokuokun 2025/05/10 Kyoto.kt #3