Fast MCP Scala

🚀 快速MCP-Scala

高度な開発者にやさしいScala 3ライブラリで、モデルコンテキストプロトコル（MCP）サーバーの構築に最適。

🚀 クイックスタート

このライブラリは、Scala 3を用いてMCPサーバーを簡単に構築するためのものです。以下のコードを参考に、すぐに始めることができます。

//> using scala 3.6.4
//> using dep com.tjclp::fast-mcp-scala:0.1.0
//> using options "-Xcheck-macros" "-experimental"

import com.tjclp.fastmcp.core.{Tool, ToolParam, Prompt, PromptParam, Resource}
import com.tjclp.fastmcp.server.FastMcpServer
import com.tjclp.fastmcp.macros.RegistrationMacro.*
import zio.*

// 定義付きのツール、プロンプト、リソースを定義
object Example:
  @Tool(name = Some("add"), description = Some("Add two numbers"))
  def add(
      @ToolParam("First operand") a: Double,
      @ToolParam("Second operand") b: Double
    ): Double = a + b

  @Prompt(name = Some("greet"), description = Some("Generate a greeting message"))
  def greet(@PromptParam("Name to greet") name: String): String =
    s"Hello, $name!"

  // 注意：リソーステンプレート（templated URIs）は未サポートです；
  // MCP Java SDKにテンプレートサポートが追加されたら実装予定です。
  @Resource(uri = "file://test", description = Some("Test resource"))
  def test(): String = "This is a test"

object ExampleServer extends ZIOAppDefault:
  override def run =
    for
      server <- ZIO.succeed(FastMcpServer("ExampleServer"))
      _      <- ZIO.attempt(server.scanAnnotations[Example.type])
      _      <- server.runStdio()
    yield ()

✨ 主な機能

• ZIOベースのエフェクト処理と非同期サポート
• アノテーション駆動のAPI (@Tool, @Resource, @Prompt)
• Scala 3マクロによるJSON Schemaとハンドラーの自動生成
• Java MCP SDKとのシームレスな統合

📦 インストール

使用sbt

以下の内容を build.sbt に追加してください：

libraryDependencies += "com.tjclp" %% "fast-mcp-scala" % "0.1.0"

使用 Scala CLI

以下のコマンドを使用してください：

//> using scala 3.6.4
//> using dep com.tjclp::fast-mcp-scala:0.1.0
//> using options "-Xcheck-macros" "-experimental"

💻 使用例

基本的な使用法

上記のコード例を参考に、Scala 3でMCPサーバーを構築することができます。

高度な使用法

実行例

上記の例は、リポジトリのルートディレクトリから scala-cli scripts/quickstart.scala を実行することで動作します。MCPインスペクターを使用してサーバーを実行するには、以下のコマンドを使用します：

npx @modelcontextprotocol/inspector scala-cli <path_to_repo>/scripts/quickstart scala

また、コマンドラインから直接例を実行することもできます：

scala-cli \
    -e '//> using dep com.tjclp::fast-mcp-scala:0.1.0'
    //> using options "-Xcheck-macros" "-experimental"

Claude Desktopとの統合

~/.config/claude 内に以下の内容のファイルを作成することができます：

export Claude=$((待実装))

📚 ドキュメント

開発に関する詳細な情報は、上記の各セクションを参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。