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/notebooks
History
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Pavel Gorgulov 0b39f57cff
 docs: streamable server sample (#595) 
- add a simple streamable http server example with auth
- update readme: replace quickstart example from sse server to
streamable server
- add readme files for samples, simple-streamable-server, notebooks

closes #170 

## How Has This Been Tested?
knit and inspector

## Breaking Changes
NaN

## Types of changes
- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [x] Documentation update

## Checklist
- [x] I have read the [MCP
Documentation](https://modelcontextprotocol.io)
- [x] My code follows the repository's style guidelines
- [x] New and existing tests pass locally
- [ ] I have added appropriate error handling
- [x] I have added or updated documentation as needed
2026-03-10 12:45:21 +01:00
..
McpClient.ipynb Prepare for next development iteration (#447) 2025-12-04 18:22:48 +02:00
README.md docs: streamable server sample (#595) 2026-03-10 12:45:21 +01:00

README.md

MCP Client Notebook

An interactive Kotlin notebook that demonstrates connecting to a remote MCP server and calling tools.

Overview

This notebook walks through building an MCP client step by step: creating a Ktor HTTP client, initializing an MCP Client, connecting via StreamableHttpClientTransport, and interacting with the server (ping, list tools, call tools). It connects to the public Microsoft Learn MCP Server as an example.

Prerequisites

How to Run

  1. Open McpClient.ipynb in IntelliJ IDEA (with Kotlin Notebook plugin) or in Jupyter with the Kotlin kernel installed.
  2. Run cells sequentially from top to bottom.

What It Demonstrates

  • Adding MCP SDK dependencies in a notebook environment
  • Creating a Ktor HttpClient with SSE and logging plugins
  • Creating an MCP Client and connecting via StreamableHttpClientTransport
  • Sending a ping request
  • Listing available tools from the remote server
  • Calling a tool (microsoft_docs_search) and displaying results