2da14b0f2e# #302 Update samples build workflow - Introduce workflow to build samples independently from the main project - Keep building samples against the current snapshot version of the SDK. Update composite build configuration. - Temporarily disable "samples/kotlin-mcp-server": the multiplatform project is broken. **It doesn't compile for me even on the main branch**. Not working with [MCP Instepcor](https://modelcontextprotocol.io/docs/tools/inspector), because CORS is not configured. Deserves a separate PR to fix. ## Motivation and Context Samples should be independently buildable ## How Has This Been Tested? <!-- Have you tested this in a real application? Which scenarios were tested? --> ## Breaking Changes <!-- Will users need to update their code or configurations? --> ## Types of changes <!-- What types of changes does your code introduce? Put an `x` in all the boxes that apply: --> - [ ] 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) - [ ] Documentation update - [x] Build improvement - [x] Tests ## Checklist <!-- Go over all the following points, and put an `x` in all the boxes that apply. --> - [x] I have read the [MCP Documentation](https://modelcontextprotocol.io) - [x] My code follows the repository's style guidelines - [ ] New and existing tests pass locally - [ ] I have added appropriate error handling - [ ] I have added or updated documentation as needed ## Additional context <!-- Add any other context, implementation notes, or design decisions -->
69 lines
2.8 KiB
Markdown
69 lines
2.8 KiB
Markdown
# Kotlin MCP Client
|
||
|
||
This project demonstrates how to build a Model Context Protocol (MCP) client in Kotlin that interacts with an MCP server
|
||
via a STDIO transport layer while leveraging Anthropic's API for natural language processing. The client uses the MCP
|
||
Kotlin SDK to communicate with an MCP server that exposes various tools, and it uses Anthropic's API to process user
|
||
queries and integrate tool responses into the conversation.
|
||
|
||
For more information about the MCP SDK and protocol, please refer to
|
||
the [MCP documentation](https://modelcontextprotocol.io/introduction).
|
||
|
||
## Prerequisites
|
||
|
||
- **Java 17 or later**
|
||
- **Gradle** (or the Gradle wrapper provided with the project)
|
||
- An Anthropic API key set in your environment variable `ANTHROPIC_API_KEY`
|
||
- Basic understanding of MCP concepts and Kotlin programming
|
||
|
||
## Overview
|
||
|
||
The client application performs the following tasks:
|
||
|
||
- **Connecting to an MCP server** —
|
||
launches an MCP server process (implemented in JavaScript, Python, or Java) using STDIO transport.
|
||
It connects to the server, retrieves available tools, and converts them to Anthropic’s tool format.
|
||
- **Processing queries** —
|
||
accepts user queries, sends them to Anthropic’s API along with the registered tools, and handles responses.
|
||
If the response indicates a tool should be called, it invokes the corresponding MCP tool and continues the
|
||
conversation based on the tool’s result.
|
||
- **Interactive chat loop** —
|
||
runs an interactive command-line loop, allowing users to continuously submit queries and receive responses.
|
||
|
||
## Building and Running
|
||
|
||
Use the Gradle wrapper to build the application. In a terminal, run:
|
||
|
||
```shell
|
||
./gradlew clean build
|
||
```
|
||
|
||
To run the client, execute the jar file and provide the path to your MCP server script.
|
||
|
||
To run the client with any MCP server:
|
||
|
||
```shell
|
||
java -jar build/libs/<your-jar-name>.jar path/to/server.jar # jvm server
|
||
java -jar build/libs/<your-jar-name>.jar path/to/server.py # python server
|
||
java -jar build/libs/<your-jar-name>.jar path/to/build/index.js # node server
|
||
```
|
||
|
||
> [!NOTE]
|
||
> The client uses STDIO transport, so it launches the MCP server as a separate process.
|
||
> Ensure the server script is executable and is a valid `.js`, `.py`, or `.jar` file.
|
||
|
||
## Configuration for Anthropic
|
||
|
||
Ensure your Anthropic API key is available in your environment:
|
||
|
||
```shell
|
||
export ANTHROPIC_API_KEY=your_anthropic_api_key_here
|
||
```
|
||
|
||
The client uses `AnthropicOkHttpClient.fromEnv()` to automatically load the API key from `ANTHROPIC_API_KEY` and
|
||
`ANTHROPIC_AUTH_TOKEN` environment variables.
|
||
|
||
## Additional Resources
|
||
|
||
- [MCP Specification](https://spec.modelcontextprotocol.io/)
|
||
- [Kotlin MCP SDK](https://github.com/modelcontextprotocol/kotlin-sdk)
|
||
- [Anthropic Java SDK](https://github.com/anthropics/anthropic-sdk-java/tree/main)
|