notebooks

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

• Kotlin Jupyter kernel or IntelliJ IDEA with the Kotlin Notebook plugin
• Internet access (the notebook connects to an external MCP server)

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