MCP Kotlin Server Sample

MCP Kotlin 服务端示例

一个使用 Kotlin 实现的 MCP（Model Communication Protocol）服务端示例，展示了适用于 JVM 和 WASM 目标的不同服务端配置和传输方式。

功能

• 多种服务端运行模式：
  • 标准 I/O 服务端（仅限 JVM）
    • 采用普通配置的 SSE（Server-Sent Events）服务端（JVM、WASM）
    • 使用 Ktor 插件的 SSE 服务端（JVM、WASM）
• 多平台支持
• 内置以下功能：
  • 提示词管理
  • 资源处理
  • 工具集成

快速开始

运行服务端

你可以在 JVM 上运行服务端，也可以在 Node.js 上使用 Kotlin/WASM 运行。

JVM：

在 JVM 上运行服务端（默认使用 Ktor 插件，以 SSE 模式在端口 3001 上运行）：

./gradlew runJvm

WASM：

在 Node.js 上使用 Kotlin/WASM 运行服务端（默认使用 Ktor 插件，以 SSE 模式在端口 3001 上运行）：

./gradlew wasmJsNodeDevelopmentRun

连接到服务端

对于运行在 JVM 或 WASM 上的服务端：

1. 启动服务端
2. 使用 MCP 检查器 连接到 http://localhost:<port>/sse

服务端功能

• 提示词：支持提示词管理，并在列表变更时发送通知
• 资源：支持订阅，并在列表变更时发送通知
• 工具：支持工具管理，并在列表变更时发送通知

实现详情

该服务端使用以下技术实现：

• Ktor：提供 HTTP 服务端功能
• Kotlin 协程：处理异步操作
• SSE：实现实时通信
• 标准 I/O：提供命令行接口
• JVM 和 WASM 目标之间共享的通用 Kotlin 代码