JSON RPC 2.0

🚀 MCP-Scala

一個基於模型上下文協議（Model Context Protocol）的服務器，使用 Scala 3 編寫，能夠為相關應用提供強大的支持。

🚀 快速開始

構建服務器

首先，使用以下命令構建服務器：

sbt fastLinkJS

客戶端配置

然後，在你的 MCP 客戶端中使用該服務器：

// 示例配置
{
  "mcpServers": {
    "mcpscala": {
      "disabled": false,
      "timeout": 30,
      "command": "sh",
      "args": ["/path/to/run.sh"],
      "transportType": "stdio"
    }
  }
}

運行工具

你可以運行以下工具：

• randomNumber
  • 在 min 到 max 之間生成一個隨機數。
• iota
  • 生成從 min 到 max 的數字序列。
• sum
  • 計算一組數字的和。

✨ 主要特性

開發階段信息

此軟件目前處於ALPHA版本，以下是開發進度：

• [x] 自動推導 JSON 模式
• [x] 定義你的工具
• [x] 文本內容部分
• [ ] 其他內容部分
• [ ] 通知處理
• [ ] 功能處理
• [x] 標準輸入輸出（stdio）傳輸
• [ ] HTTP 傳輸
• [ ] 授權功能

此實現需要你的關注和貢獻。歡迎通過打開問題或提交拉取請求來參與此項目。

💻 使用示例

基礎用法

查看 StdioMain.scala 文件以獲取詳細信息。

package dev.capslock.mcpscala

import cats.effect.IO
import cats.effect.IOApp
import dev.capslock.mcpscala.transport.StdioServer
import dev.capslock.mcpscala.mcp.ContentPart
import sttp.tapir.Schema.annotations.description

case class RandomNumberInput(
    @description("最小值（包含在內）") min: Int,
    @description("最大值（不包含）") max: Int
) derives io.circe.Decoder,
      sttp.tapir.Schema

def randomNumber(input: RandomNumberInput): IO[Seq[ContentPart]] = IO {
  val random = scala.util.Random.between(input.min, input.max)
  Seq(ContentPart.TextContentPart(random.toString))
}

/** 標準輸入輸出服務器的主入口點。
  */
object StdioMain extends IOApp.Simple {
  val tools = Map(
    "randomNumber" -> server.Tool(randomNumber),
  )

  def run: IO[Unit] = {
    StdioServer.serve(Handler.methodHandlers(tools))
  }
}