JSON RPC 2.0

🚀 MCP - Scala

このプロジェクトは、モデルコンテキストプロトコル（Model Context Protocol）に基づくサーバーで、Scala 3 を使用して開発されています。

🚀 クイックスタート

開発段階

このソフトウェアは現在ALPHAバージョンです。

• [x] JSON スキーマの自動導出
• [x] ツールの定義
• [x] テキストコンテンツ部分
• [ ] その他のコンテンツ部分
• [ ] 通知処理
• [ ] 機能処理
• [x] 標準入出力（stdio）伝送
• [ ] HTTP 伝送
• [ ] 認証機能

この実装にはあなたの注目と貢献が必要です。問題を開くか、プルリクエストを送信することで、このプロジェクトに参加することができます。

デモ

まず、以下のコマンドを使用してサーバーを構築します。

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
  • 一連の数字の合計を計算します。

💻 使用例

基本的な使用法

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))
  }
}

高度な使用法

あなた自身のツールを実装するには、StdioMain.scala ファイルを参照してください。上記のコード例を参考に、独自の機能を追加することができます。