Kotlin Cyrpto Price Spring MCP Server Demo

🚀 Kotlin暗号通貨価格Spring MCPサーバーデモ

このプロジェクトは、Spring AIのモデルコンテキストプロトコル（MCP）サーバーと暗号通貨価格APIサービスの統合を示すデモンストレーションです。AIモデルは、このプロジェクトによって提供される標準化されたインターフェースを通じて、リアルタイムの暗号通貨情報を取得することができます。

🚀 クイックスタート

このプロジェクトは、MCPサーバーとして機能するSpring Bootアプリケーションを実装しています。これにより、AIモデルは以下のことが可能になります。

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

📦 インストール

前提条件

• JDK 21以上
• Gradle

アプリケーションの実行

./gradlew bootRun

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

💻 使用例

基礎的な使用法

1. 暗号通貨の検索

@Tool(description = "搜索用户输入查询的加密货币信息。")
fun searchCryptocurrency(query: String): CryptoData

2. 市場データの取得

@Tool(description = "根据ID获取加密货币的市场数据。此ID必须由searchCryptocurrency工具的返回值提供。")
fun getMarketDataByCryptocurrencyId(id: String): CryptoMarketData

📚 ドキュメント

プロジェクト構造

src/main/kotlin/org/gaplo917/mcpservercoinprice/
├── CoinPriceService.kt         # 暗号通貨データ取得サービス
├── McpServerCoinPriceApplication.kt  # メインアプリケーションクラス

データモデル

• CryptoData：暗号通貨のリスト、取引所、カテゴリ、およびNFTを含みます。
• CryptoMarketData：特定の暗号通貨の市場情報（取引ペアを含む）を含みます。
• Coin：暗号通貨を表し、ID、名称、シンボル、および時価総額ランキングを持ちます。
• Ticker：特定の市場における暗号通貨の取引情報を含みます。

AIモデルとの統合

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

📄 ライセンス

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

参考資料

• Spring AIドキュメント
• モデルコンテキストプロトコル
• CoinGecko API