adds support for server instructions

Author: jclyne

misk-mcp/api/misk-mcp.api

@@ -41,13 +41,14 @@ public final class misk/mcp/McpResourceModule$Companion {
 
 public final class misk/mcp/McpServerModule : misk/inject/KAbstractModule {
 	public static final field Companion Lmisk/mcp/McpServerModule$Companion;
-	public synthetic fun <init> (Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lkotlin/reflect/KClass;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public synthetic fun <init> (Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lcom/google/inject/Provider;Lkotlin/reflect/KClass;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
 }
 
 public final class misk/mcp/McpServerModule$Companion {
-	public final fun create (Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lkotlin/reflect/KClass;)Lmisk/mcp/McpServerModule;
-	public static synthetic fun create$default (Lmisk/mcp/McpServerModule$Companion;Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lkotlin/reflect/KClass;ILjava/lang/Object;)Lmisk/mcp/McpServerModule;
-	public final fun createWithNoGroup (Ljava/lang/String;Lmisk/mcp/config/McpConfig;)Lmisk/mcp/McpServerModule;
+	public final fun create (Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lcom/google/inject/Provider;Lkotlin/reflect/KClass;)Lmisk/mcp/McpServerModule;
+	public static synthetic fun create$default (Lmisk/mcp/McpServerModule$Companion;Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lcom/google/inject/Provider;Lkotlin/reflect/KClass;ILjava/lang/Object;)Lmisk/mcp/McpServerModule;
+	public final fun createWithNoGroup (Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lcom/google/inject/Provider;)Lmisk/mcp/McpServerModule;
+	public static synthetic fun createWithNoGroup$default (Lmisk/mcp/McpServerModule$Companion;Ljava/lang/String;Lmisk/mcp/config/McpConfig;Lcom/google/inject/Provider;ILjava/lang/Object;)Lmisk/mcp/McpServerModule;
 }
 
 public abstract interface class misk/mcp/McpSessionHandler {

misk-mcp/src/main/kotlin/misk/mcp/McpServerModule.kt

@@ -31,6 +31,7 @@ import kotlin.reflect.KClass
 class McpServerModule private constructor(
   private val name: String,
   private val config: McpConfig,
+  private val instructionsProvider: Provider<String>?,
   private val groupAnnotationClass: KClass<out Annotation>?,
 ) : KAbstractModule() {
 
@@ -68,6 +69,7 @@ class McpServerModule private constructor(
         tools = toolsProvider.get().toSet(),
         resources = resourcesProvider.get().toSet(),
         prompts = promptsProvider.get().toSet(),
+        instructionsProvider = instructionsProvider
       )
     }
     bind(serverKey).toProvider(serverProvider).asSingleton()
@@ -90,13 +92,20 @@ class McpServerModule private constructor(
     fun create(
       name: String,
       config: McpConfig,
+      instructionsProvider: Provider<String>? = null,
       groupAnnotation: KClass<out Annotation>? = null,
-    ) = McpServerModule(name, config, groupAnnotation)
+    ) = McpServerModule(name, config, instructionsProvider, groupAnnotation)
 
-    inline fun <reified GA : Annotation> create(name: String, config: McpConfig) = create(name, config, GA::class)
+    inline fun <reified GA : Annotation> create(
+      name: String,
+      config: McpConfig,
+      instructionsProvider: Provider<String>? = null
+    ) =
+      create(name, config, instructionsProvider, GA::class)
 
     @JvmName("createWithNoGroup")
-    fun create(name: String, config: McpConfig) = create(name, config, null)
+    fun create(name: String, config: McpConfig, instructionsProvider: Provider<String>? = null) =
+      create(name, config, instructionsProvider, null)
   }
 
   private class CommonModule() : KInstallOnceModule() {

misk-mcp/src/main/kotlin/misk/mcp/MiskMcpServer.kt

@@ -1,5 +1,6 @@
 package misk.mcp
 
+import com.google.inject.Provider
 import io.modelcontextprotocol.kotlin.sdk.Implementation
 import io.modelcontextprotocol.kotlin.sdk.JSONRPCMessage
 import io.modelcontextprotocol.kotlin.sdk.JSONRPCNotification
@@ -106,6 +107,7 @@ class MiskMcpServer internal constructor(
   tools: Set<McpTool<*>>,
   resources: Set<McpResource>,
   prompts: Set<McpPrompt>,
+  instructionsProvider: Provider<String>? = null,
 ) : Server(
   Implementation(
     name = name,
@@ -121,6 +123,7 @@ class MiskMcpServer internal constructor(
       tools = if (tools.isNotEmpty()) config.tools.asTools() else null,
     ),
   ),
+  // TODO: propagate instructionsProvider once supported in MCP SDK
 ) {
 
   init {