| Filename | Latest commit message | Latest commit date |
|---|---|---|
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 --> |
||
| .. | ||
| gradle | ||
| src/main | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| README.md | ||
| settings.gradle.kts | ||
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.
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:
./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:
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.jarfile.
Configuration for Anthropic
Ensure your Anthropic API key is available in your environment:
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.