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
dependabot[bot] ba265a52ad
 chore(deps): bump mcp-kotlin from 0.11.0 to 0.11.1 in /samples/kotlin-mcp-server (#700) 
Bumps `mcp-kotlin` from 0.11.0 to 0.11.1.
Updates `io.modelcontextprotocol:kotlin-sdk-client` from 0.11.0 to
0.11.1
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/modelcontextprotocol/kotlin-sdk/releases">io.modelcontextprotocol:kotlin-sdk-client's
releases</a>.</em></p>
<blockquote>
<h2>0.11.1</h2>
<h3>Description</h3>
<p>Fixes an SSE stream crash on Netty when clients connect to the
Streamable HTTP GET endpoint.</p>
<h3>Fixed</h3>
<ul>
<li>Fixed GET SSE stream crash on Netty in Streamable HTTP where
<code>appendSseHeaders()</code> was called after response headers were
already committed, causing <code>UnsupportedOperationException</code>
and client retry loops by <a
href="https://github.com/devcrocod"><code>@​devcrocod</code></a> in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/681">#681</a></li>
</ul>
<h3>Dependencies</h3>
<ul>
<li>mcp-kotlin to v0.11.0 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/672">#672</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/673">#673</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/675">#675</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/676">#676</a></li>
<li>Ktor BOM to v3.3.3 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/650">#650</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/653">#653</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/656">#656</a></li>
<li>Kotest assertions to v6.1.11 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/674">#674</a></li>
<li>anthropic-java to v2.19.0 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/671">#671</a></li>
<li><code>@​modelcontextprotocol/sdk</code> to v1.29.0,
<code>@​types/node</code> update in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/677">#677</a></li>
<li>hono to v4.12.12 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/680">#680</a></li>
<li><code>@​hono/node-server</code> to v1.19.13 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/679">#679</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/modelcontextprotocol/kotlin-sdk/compare/0.11.0...0.11.1">https://github.com/modelcontextprotocol/kotlin-sdk/compare/0.11.0...0.11.1</a></p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="f02f5d3d10"><code>f02f5d3</code></a>
release: bump mcp kotlin-sdk version to 0.11.1 (<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/issues/682">#682</a>)</li>
<li><a
href="8a7f9f8d31"><code>8a7f9f8</code></a>
fix(server): GET SSE stream crash on Netty in Streamable HTTP (<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/issues/681">#681</a>)</li>
<li><a
href="cceca4df58"><code>cceca4d</code></a>
chore(deps): bump io.ktor:ktor-bom from 3.2.3 to 3.3.3 in
/samples/kotlin-mcp...</li>
<li><a
href="12171dc2ec"><code>12171dc</code></a>
chore(deps): bump hono from 4.12.9 to 4.12.12 in
/integration-test/src/jvmTes...</li>
<li><a
href="66d17956c1"><code>66d1795</code></a>
chore(deps): bump <code>@​hono/node-server</code> from 1.19.11 to
1.19.13 in /integration-t...</li>
<li><a
href="8442ab852b"><code>8442ab8</code></a>
chore(deps): bump com.anthropic:anthropic-java from 2.18.0 to 2.19.0 in
/samp...</li>
<li><a
href="20ac69f9af"><code>20ac69f</code></a>
chore(deps): bump mcp-kotlin from 0.10.0 to 0.11.0 in
/samples/simple-streama...</li>
<li><a
href="4144db6736"><code>4144db6</code></a>
chore(deps): bump io.modelcontextprotocol:kotlin-sdk-client from 0.10.0
to 0....</li>
<li><a
href="3f7f499dbe"><code>3f7f499</code></a>
chore(deps): bump mcp-kotlin from 0.10.0 to 0.11.0 in
/samples/kotlin-mcp-ser...</li>
<li><a
href="7c87ed1ba5"><code>7c87ed1</code></a>
chore(deps): bump the kotest group with 3 updates (<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/issues/674">#674</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/modelcontextprotocol/kotlin-sdk/compare/0.11.0...0.11.1">compare
view</a></li>
</ul>
</details>
<br />

Updates `io.modelcontextprotocol:kotlin-sdk-server` from 0.11.0 to
0.11.1
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/modelcontextprotocol/kotlin-sdk/releases">io.modelcontextprotocol:kotlin-sdk-server's
releases</a>.</em></p>
<blockquote>
<h2>0.11.1</h2>
<h3>Description</h3>
<p>Fixes an SSE stream crash on Netty when clients connect to the
Streamable HTTP GET endpoint.</p>
<h3>Fixed</h3>
<ul>
<li>Fixed GET SSE stream crash on Netty in Streamable HTTP where
<code>appendSseHeaders()</code> was called after response headers were
already committed, causing <code>UnsupportedOperationException</code>
and client retry loops by <a
href="https://github.com/devcrocod"><code>@​devcrocod</code></a> in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/681">#681</a></li>
</ul>
<h3>Dependencies</h3>
<ul>
<li>mcp-kotlin to v0.11.0 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/672">#672</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/673">#673</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/675">#675</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/676">#676</a></li>
<li>Ktor BOM to v3.3.3 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/650">#650</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/653">#653</a>,
<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/656">#656</a></li>
<li>Kotest assertions to v6.1.11 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/674">#674</a></li>
<li>anthropic-java to v2.19.0 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/671">#671</a></li>
<li><code>@​modelcontextprotocol/sdk</code> to v1.29.0,
<code>@​types/node</code> update in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/677">#677</a></li>
<li>hono to v4.12.12 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/680">#680</a></li>
<li><code>@​hono/node-server</code> to v1.19.13 in <a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/pull/679">#679</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/modelcontextprotocol/kotlin-sdk/compare/0.11.0...0.11.1">https://github.com/modelcontextprotocol/kotlin-sdk/compare/0.11.0...0.11.1</a></p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="f02f5d3d10"><code>f02f5d3</code></a>
release: bump mcp kotlin-sdk version to 0.11.1 (<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/issues/682">#682</a>)</li>
<li><a
href="8a7f9f8d31"><code>8a7f9f8</code></a>
fix(server): GET SSE stream crash on Netty in Streamable HTTP (<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/issues/681">#681</a>)</li>
<li><a
href="cceca4df58"><code>cceca4d</code></a>
chore(deps): bump io.ktor:ktor-bom from 3.2.3 to 3.3.3 in
/samples/kotlin-mcp...</li>
<li><a
href="12171dc2ec"><code>12171dc</code></a>
chore(deps): bump hono from 4.12.9 to 4.12.12 in
/integration-test/src/jvmTes...</li>
<li><a
href="66d17956c1"><code>66d1795</code></a>
chore(deps): bump <code>@​hono/node-server</code> from 1.19.11 to
1.19.13 in /integration-t...</li>
<li><a
href="8442ab852b"><code>8442ab8</code></a>
chore(deps): bump com.anthropic:anthropic-java from 2.18.0 to 2.19.0 in
/samp...</li>
<li><a
href="20ac69f9af"><code>20ac69f</code></a>
chore(deps): bump mcp-kotlin from 0.10.0 to 0.11.0 in
/samples/simple-streama...</li>
<li><a
href="4144db6736"><code>4144db6</code></a>
chore(deps): bump io.modelcontextprotocol:kotlin-sdk-client from 0.10.0
to 0....</li>
<li><a
href="3f7f499dbe"><code>3f7f499</code></a>
chore(deps): bump mcp-kotlin from 0.10.0 to 0.11.0 in
/samples/kotlin-mcp-ser...</li>
<li><a
href="7c87ed1ba5"><code>7c87ed1</code></a>
chore(deps): bump the kotest group with 3 updates (<a
href="https://redirect.github.com/modelcontextprotocol/kotlin-sdk/issues/674">#674</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/modelcontextprotocol/kotlin-sdk/compare/0.11.0...0.11.1">compare
view</a></li>
</ul>
</details>
<br />

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-04-14 21:28:47 +00:00
..
gradle chore(deps): bump mcp-kotlin from 0.11.0 to 0.11.1 in /samples/kotlin-mcp-server (#700) 2026-04-14 21:28:47 +00:00
src Fix kotlin-mcp-server sample (#459) 2025-12-08 23:25:55 +02:00
build.gradle.kts Update Kotlin-MCP-Server with STDIO support, logging & CORS (#371) 2025-11-06 18:18:04 +02:00
gradle.properties #302 Update samples build workflow (#330) 2025-10-23 13:02:22 +03:00
gradlew chore(deps): bump the other-dependencies group across 4 directories with 4 updates (#634) 2026-03-27 00:58:15 +00:00
gradlew.bat chore(deps): bump the other-dependencies group across 4 directories with 4 updates (#634) 2026-03-27 00:58:15 +00:00
mcp-inspector-config.json Update Kotlin-MCP-Server with STDIO support, logging & CORS (#371) 2025-11-06 18:18:04 +02:00
README.md docs: streamable server sample (#595) 2026-03-10 12:45:21 +01:00
settings.gradle.kts #302 Update samples build workflow (#330) 2025-10-23 13:02:22 +03:00

README.md

Kotlin MCP Server

A sample MCP server demonstrating multiple transport modes: STDIO, SSE (plain), and SSE (Ktor plugin).

Note: The SSE transport modes are provided for backward compatibility. For new projects, consider using the simple-streamable-server sample, which uses the recommended Streamable HTTP transport.

Overview

This sample registers a prompt, a tool, and a resource, then lets you choose how to expose them. STDIO mode is the default and is best for process-based clients. The two SSE modes show how to serve MCP over HTTP using either a manual Ktor routing setup or the built-in mcp { } Ktor plugin.

Prerequisites

Build & Run

STDIO mode (default)

./gradlew run

Or explicitly:

./gradlew run --args="--stdio"

Connect with the MCP Inspector:

npx @modelcontextprotocol/inspector --config samples/kotlin-mcp-server/mcp-inspector-config.json --server stdio-server

SSE with Ktor plugin

./gradlew run --args="--sse-server-ktor 3002"

Connect with the MCP Inspector:

npx @modelcontextprotocol/inspector --config samples/kotlin-mcp-server/mcp-inspector-config.json --server sse-ktor-server

SSE with plain configuration

Known issue: This mode may not work correctly at this time.

./gradlew run --args="--sse-server 3001"

Connect with the MCP Inspector:

npx @modelcontextprotocol/inspector --config samples/kotlin-mcp-server/mcp-inspector-config.json --server sse-server

MCP Capabilities

Tools

Name Description
kotlin-sdk-tool A test tool that returns a "Hello, world!" greeting.

Prompts

Name Description
Kotlin Developer Generates a prompt to develop a small Kotlin application for a given project name.

Resources

Name URI Description
Web Search https://search.com/ A placeholder resource demonstrating resource handling.