MCP Kotlin Server Sample

MCP Kotlin Server Sample

JVM と WASM の両方を対象に、さまざまなサーバー構成とトランスポート方式を示す、Kotlin による MCP（Model Communication Protocol）サーバーのサンプル実装です。

機能

• 複数のサーバー動作モード：
  • 標準入出力サーバー（JVM のみ）
    • シンプルな構成の SSE（Server-Sent Events）サーバー（JVM、WASM）
    • Ktor プラグインを使用する SSE サーバー（JVM、WASM）
• マルチプラットフォーム対応
• 組み込みの機能：
  • プロンプトの管理
  • リソースの処理
  • ツールの統合

はじめに

サーバーの実行

サーバーは JVM 上、または Node.js 上の Kotlin/WASM を使用して実行できます。

JVM：

JVM 上でサーバーを実行するには、次のコマンドを使用します（デフォルトでは、ポート 3001 で Ktor プラグインを使用する SSE モードで起動します）。

./gradlew runJvm

WASM：

Node.js 上の Kotlin/WASM を使用してサーバーを実行するには、次のコマンドを使用します（デフォルトでは、ポート 3001 で Ktor プラグインを使用する SSE モードで起動します）。

./gradlew wasmJsNodeDevelopmentRun

サーバーへの接続

JVM または WASM 上のサーバーの場合：

1. サーバーを起動します
2. MCP inspector を使用して http://localhost:<port>/sse に接続します

サーバーの機能

• プロンプト：リストの変更通知を含むプロンプト管理に対応しています
• リソース：サブスクリプションへの対応とリストの変更通知を含みます
• ツール：リストの変更通知を含むツール管理に対応しています

実装の詳細

サーバーは次の技術を使用して実装されています：

• HTTP サーバー機能には Ktor
• 非同期処理には Kotlin コルーチン
• リアルタイム通信には SSE
• コマンドラインインターフェイスには標準入出力
• JVM と WASM の両方のターゲットで共有される共通の Kotlin コード