| Filename | Latest commit message | Latest commit date |
|---|---|---|
f9d491e4faBumps gradle-wrapper from 9.3.0 to 9.3.1. [](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> <br /> You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Konstantin Pavlov <1517853+kpavlov@users.noreply.github.com> |
||
| .. | ||
| gradle | ||
| src | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| mcp-inspector-config.json | ||
| README.md | ||
| settings.gradle.kts | ||
MCP Kotlin Server Sample
A sample implementation of an MCP (Model Context Protocol) server in Kotlin that demonstrates different server configurations and transport methods.
Features
- Multiple server operation modes:
- Standard I/O server
- SSE (Server-Sent Events) server with plain configuration
- SSE server using Ktor plugin
- Built-in capabilities for:
- Prompts management
- Resources handling
- Tools integration
Getting Started
Running the Server
The server defaults STDIO transport.
You can customize the behavior using command-line arguments. Logs are printed to ./build/stdout.log
Standard I/O mode (STDIO):
./gradlew clean build
Use the MCP inspector to connect to MCP via STDIO (Click the "▶️ Connect" button):
npx @modelcontextprotocol/inspector --config mcp-inspector-config.json --server stdio-server
SSE with plain configuration:
NB!: 🐞 This configuration may not work ATM
./gradlew run --args="--sse-server 3001"
or
./gradlew clean build
java -jar ./build/libs/kotlin-mcp-server-0.1.0-all.jar --sse-server 3001
Use the MCP inspector
to connect to http://localhost:3002/ via SSE Transport (Click the "▶️ Connect" button):
npx @modelcontextprotocol/inspector --config mcp-inspector-config.json --server sse-server
SSE with Ktor plugin:
./gradlew run --args="--sse-server-ktor 3002"
or
./gradlew clean build
java -jar ./build/libs/kotlin-mcp-server-0.1.0-all.jar --sse-server-ktor 3002
Use the MCP inspector
to connect to http://localhost:3002/ via SSE transport (Click the "▶️ Connect" button):
npx @modelcontextprotocol/inspector --config mcp-inspector-config.json --server sse-ktor-server
Server Capabilities
- Prompts: Supports prompt management with list change notifications
- Resources: Includes subscription support and list change notifications
- Tools: Supports tool management with list change notifications
Implementation Details
The server is implemented using:
- Ktor for HTTP server functionality (SSE modes)
- Kotlin coroutines for asynchronous operations
- SSE for real-time communication in web contexts
- Standard I/O for command-line interface and process-based communication
Example Capabilities
The sample server demonstrates:
- Prompt: "Kotlin Developer" - helps develop small Kotlin applications with a configurable project name
- Tool: "kotlin-sdk-tool" - a simple test tool that returns a greeting
- Resource: "Web Search" - a placeholder resource demonstrating resource handling