import io.ktor.http.* import io.ktor.server.application.* import io.ktor.server.cio.* import io.ktor.server.engine.* import io.ktor.server.response.* import io.ktor.server.routing.* import io.ktor.server.sse.* import io.ktor.util.collections.* import io.modelcontextprotocol.kotlin.sdk.* import io.modelcontextprotocol.kotlin.sdk.GetPromptResult import io.modelcontextprotocol.kotlin.sdk.Implementation import io.modelcontextprotocol.kotlin.sdk.PromptArgument import io.modelcontextprotocol.kotlin.sdk.PromptMessage import io.modelcontextprotocol.kotlin.sdk.Role import io.modelcontextprotocol.kotlin.sdk.ServerCapabilities import io.modelcontextprotocol.kotlin.sdk.Tool import io.modelcontextprotocol.kotlin.sdk.server.Server import io.modelcontextprotocol.kotlin.sdk.server.ServerOptions import io.modelcontextprotocol.kotlin.sdk.server.SseServerTransport import io.modelcontextprotocol.kotlin.sdk.server.StdioServerTransport import io.modelcontextprotocol.kotlin.sdk.server.mcp import kotlinx.coroutines.Job import kotlinx.coroutines.runBlocking import kotlinx.io.asSink import kotlinx.io.asSource import kotlinx.io.buffered /** * Start sse-server mcp on port 3001. * * @param args * - "--stdio": Runs an MCP server using standard input/output. * - "--sse-server-ktor ": Runs an SSE MCP server using Ktor plugin (default if no argument is provided). * - "--sse-server ": Runs an SSE MCP server with a plain configuration. */ fun main(args: Array) { val command = args.firstOrNull() ?: "--sse-server-ktor" val port = args.getOrNull(1)?.toIntOrNull() ?: 3001 when (command) { "--stdio" -> runMcpServerUsingStdio() "--sse-server-ktor" -> runSseMcpServerUsingKtorPlugin(port) "--sse-server" -> runSseMcpServerWithPlainConfiguration(port) else -> { System.err.println("Unknown command: $command") } } } fun configureServer(): Server { val server = Server( Implementation( name = "mcp-kotlin test server", version = "0.1.0" ), ServerOptions( capabilities = ServerCapabilities( prompts = ServerCapabilities.Prompts(listChanged = true), resources = ServerCapabilities.Resources(subscribe = true, listChanged = true), tools = ServerCapabilities.Tools(listChanged = true), ) ) ) server.addPrompt( name = "Kotlin Developer", description = "Develop small kotlin applications", arguments = listOf( PromptArgument( name = "Project Name", description = "Project name for the new project", required = true ) ) ) { request -> GetPromptResult( "Description for ${request.name}", messages = listOf( PromptMessage( role = Role.user, content = TextContent("Develop a kotlin project named ${request.arguments?.get("Project Name")}") ) ) ) } // Add a tool server.addTool( name = "kotlin-sdk-tool", description = "A test tool", inputSchema = Tool.Input() ) { request -> CallToolResult( content = listOf(TextContent("Hello, world!")) ) } // Add a resource server.addResource( uri = "https://search.com/", name = "Web Search", description = "Web search engine", mimeType = "text/html" ) { request -> ReadResourceResult( contents = listOf( TextResourceContents("Placeholder content for ${request.uri}", request.uri, "text/html") ) ) } return server } fun runMcpServerUsingStdio() { // Note: The server will handle listing prompts, tools, and resources automatically. // The handleListResourceTemplates will return empty as defined in the Server code. val server = configureServer() val transport = StdioServerTransport( inputStream = System.`in`.asSource().buffered(), outputStream = System.out.asSink().buffered() ) runBlocking { server.connect(transport) val done = Job() server.onClose { done.complete() } done.join() println("Server closed") } } fun runSseMcpServerWithPlainConfiguration(port: Int): Unit = runBlocking { val servers = ConcurrentMap() println("Starting sse server on port $port. ") println("Use inspector to connect to the http://localhost:$port/sse") embeddedServer(CIO, host = "0.0.0.0", port = port) { install(SSE) routing { sse("/sse") { val transport = SseServerTransport("/message", this) val server = configureServer() // For SSE, you can also add prompts/tools/resources if needed: // server.addTool(...), server.addPrompt(...), server.addResource(...) servers[transport.sessionId] = server server.onClose { println("Server closed") servers.remove(transport.sessionId) } server.connect(transport) } post("/message") { println("Received Message") val sessionId: String = call.request.queryParameters["sessionId"]!! val transport = servers[sessionId]?.transport as? SseServerTransport if (transport == null) { call.respond(HttpStatusCode.NotFound, "Session not found") return@post } transport.handlePostMessage(call) } } }.start(wait = true) } /** * Starts an SSE (Server Sent Events) MCP server using the Ktor framework and the specified port. * * The url can be accessed in the MCP inspector at [http://localhost:$port] * * @param port The port number on which the SSE MCP server will listen for client connections. * @return Unit This method does not return a value. */ fun runSseMcpServerUsingKtorPlugin(port: Int): Unit = runBlocking { println("Starting sse server on port $port") println("Use inspector to connect to the http://localhost:$port/sse") embeddedServer(CIO, host = "0.0.0.0", port = port) { mcp { return@mcp configureServer() } }.start(wait = true) }