modelcontextprotocol/kotlin-sdk
Watch
1
0
Fork
You've already forked kotlin-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
kotlin-sdk/samples/kotlin-mcp-server
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Pavel Gorgulov 0cff2ca718
 add ios and wasm targets (#81) 
* add wasm and ios targets

* add yarn.lock file to gitignore

* clean up code

* fix typo in method name

* add wasm server example

* update jrelease publishing for klibs

* update gradle-publish workflow to use macos runner

* update README to reflect multiplatform support and clarify server setup for JVM and WASM

* remove the old main file from the kotlin-mcp-server example

* update api dump

* Refactor `build.gradle.kts`

* clean up imports and remove unnecessary charset specification in tests

* add JS target configuration and update API dump
2025-05-29 05:01:50 +00:00
..
.idea Update sample to 0.1.0 2024-12-17 20:19:11 +01:00
gradle/wrapper Add server sample (#8) 2024-12-16 13:27:00 +01:00
src add ios and wasm targets (#81) 2025-05-29 05:01:50 +00:00
.gitignore Add server sample (#8) 2024-12-16 13:27:00 +01:00
build.gradle.kts add ios and wasm targets (#81) 2025-05-29 05:01:50 +00:00
gradle.properties add ios and wasm targets (#81) 2025-05-29 05:01:50 +00:00
gradlew Add server sample (#8) 2024-12-16 13:27:00 +01:00
gradlew.bat Add server sample (#8) 2024-12-16 13:27:00 +01:00
README.md add ios and wasm targets (#81) 2025-05-29 05:01:50 +00:00
settings.gradle.kts add ios and wasm targets (#81) 2025-05-29 05:01:50 +00:00

README.md

MCP Kotlin Server Sample

A sample implementation of an MCP (Model Communication Protocol) server in Kotlin that demonstrates different server configurations and transport methods for both JVM and WASM targets.

Features

  • Multiple server operation modes:
    • Standard I/O server (JVM only)
      • SSE (Server-Sent Events) server with plain configuration (JVM, WASM)
      • SSE server using Ktor plugin (JVM, WASM)
  • Multiplatform support
  • Built-in capabilities for:
    • Prompts management
    • Resources handling
    • Tools integration

Getting Started

Running the Server

You can run the server on the JVM or using Kotlin/WASM on Node.js.

JVM:

To run the server on the JVM (defaults to SSE mode with Ktor plugin on port 3001):

./gradlew runJvm

WASM:

To run the server using Kotlin/WASM on Node.js (defaults to SSE mode with Ktor plugin on port 3001):

./gradlew wasmJsNodeDevelopmentRun

Connecting to the Server

For servers on JVM or WASM:

  1. Start the server
  2. Use the MCP inspector to connect to http://localhost:<port>/sse

Server Capabilities

  • Prompts: Supports prompt management with list change notifications
  • Resources: Includes subscription support and list change notifications
  • Tools: Supports tool management with list change notifications

Implementation Details

The server is implemented using:

  • Ktor for HTTP server functionality
  • Kotlin coroutines for asynchronous operations
  • SSE for real-time communication
  • Standard I/O for command-line interface
  • Common Kotlin code shared between JVM and WASM targets