Kotlin Crypto Price Spring MCP Server Demo

Kotlin Crypto Price Spring MCP Server デモ

Spring AI の Model Context Protocol（MCP）サーバーと暗号資産価格 API サービスの連携を紹介するデモプロジェクトです。このプロジェクトでは、標準化されたインターフェースを通じて、AI モデルがリアルタイムの暗号資産情報を取得できます。

概要

このプロジェクトでは、AI モデル向けに次のツールを提供する MCP サーバーとして、Spring Boot アプリケーションを実装しています。

1. 名前またはシンボルで暗号資産を検索する
2. 特定の暗号資産の市場データを取得する

このアプリケーションでは、CoinGecko API を使用してリアルタイムの暗号資産データを取得します。

機能

• 暗号資産の検索：暗号資産、取引所、カテゴリ、NFT を検索します
• 市場データの取得：特定の暗号資産の詳細な市場データを取得します
• MCP 連携：Spring AI の MCP サーバーを介して、機能を AI モデル向けのツールとして公開します
• ロギング：ツールのリクエストとレスポンスを包括的に記録します

技術スタック

• Kotlin 1.9.25
• Spring Boot 3.4.4
• Spring AI MCP Server
• Model Context Protocol SDK 0.8.1
• Java 21

プロジェクト構成

src/main/kotlin/org/gaplo917/mcpservercoinprice/
├── CoinPriceService.kt         # Service for cryptocurrency data retrieval
├── McpServerCoinPriceApplication.kt  # Main application class

はじめに

前提条件

• JDK 21 以降
• Gradle

アプリケーションの実行

./gradlew bootRun

MCP サーバーはデフォルトのポート（通常は 8080）で起動します。

API ツール

このアプリケーションでは、AI モデル向けに次のツールを公開しています。

1. 暗号資産を検索

@Tool(description = "search cryptocurrency information by user input query.")
fun searchCryptocurrency(query: String): CryptoData

2. 市場データを取得

@Tool(description = "get cryptocurrency market data by id. The id must be used by the return of the searchCryptocurrency tools.")
fun getMarketDataByCryptocurrencyId(id: String): CryptoMarketData

データモデル

• CryptoData：コイン、取引所、カテゴリ、NFT のリストを含みます
• CryptoMarketData：特定の暗号資産のティッカーを含む市場データを含みます
• Coin：ID、名前、シンボル、時価総額ランキングを持つ暗号資産を表します
• Ticker：特定の市場における暗号資産の取引情報を含みます

AI モデルとの連携

このサーバーは、Model Context Protocol（MCP）をサポートする AI モデルと使用できます。これにより、AI モデルは標準化された方法で暗号資産データを取得できます。Spring AI MCP Server が、AI モデルと暗号資産サービス間の通信を処理します。

ライセンス

このプロジェクトは、LICENSE ファイルに記載された条件に基づいてライセンスされています。

参考資料

• Spring AI ドキュメント
• Model Context Protocol
• CoinGecko API