Kotlin Cyrpto Price Spring MCP Server Demo

🚀 Kotlin加密貨幣價格Spring MCP服務器演示

本項目是一個示範項目，展示了Spring AI的模型上下文協議（MCP）服務器與加密貨幣價格API服務的集成。藉助該項目，AI模型可通過標準化接口獲取即時加密貨幣信息，為加密貨幣數據的智能化應用提供了有效解決方案。

🚀 快速開始

前提條件

• JDK 21或更高版本
• Gradle

運行應用程序

./gradlew bootRun

MCP服務器將在默認端口（通常為8080）啟動。

✨ 主要特性

• 加密貨幣搜索：可根據用戶輸入查詢搜索加密貨幣、交易所、類別和NFT。
• 市場數據檢索：能獲取特定加密貨幣的詳細市場信息。
• MCP集成：通過Spring AI的MCP服務器將功能暴露為工具，供AI模型使用。
• 日誌記錄：全面記錄工具請求和響應，方便後續分析和調試。

📦 安裝指南

前提條件

確保你已安裝JDK 21或更高版本以及Gradle。

啟動應用

在項目根目錄下執行以下命令啟動應用：

./gradlew bootRun

💻 使用示例

基礎用法

搜索加密貨幣

@Tool(description = "搜索用戶輸入查詢的加密貨幣信息。")
fun searchCryptocurrency(query: String): CryptoData

獲取市場數據

@Tool(description = "根據ID獲取加密貨幣的市場數據。此ID必須由searchCryptocurrency工具的返回值提供。")
fun getMarketDataByCryptocurrencyId(id: String): CryptoMarketData

📚 詳細文檔

項目結構

src/main/kotlin/org/gaplo917/mcpservercoinprice/
├── CoinPriceService.kt         # 加密貨幣數據檢索服務
├── McpServerCoinPriceApplication.kt  # 主應用程序類

API工具

該應用向AI模型公開以下工具：

1. 搜索加密貨幣

@Tool(description = "搜索用戶輸入查詢的加密貨幣信息。")
fun searchCryptocurrency(query: String): CryptoData

2. 獲取市場數據

@Tool(description = "根據ID獲取加密貨幣的市場數據。此ID必須由searchCryptocurrency工具的返回值提供。")
fun getMarketDataByCryptocurrencyId(id: String): CryptoMarketData

數據模型

• CryptoData：包含加密貨幣列表、交易所、類別和NFT。
• CryptoMarketData：包含特定加密貨幣的市場信息，包括交易對。
• Coin：表示一種加密貨幣及其ID、名稱、符號和市值排名。
• Ticker：包含特定市場中加密貨幣的交易信息。

與AI模型集成

此服務器可以與支持Model Context Protocol (MCP)的AI模型一起使用，允許它們以標準化方式檢索加密貨幣數據。Spring AI MCP Server處理AI模型與加密貨幣服務之間的通信。

🔧 技術細節

該項目採用了以下技術：

📄 許可證

該項目在LICENSE文件中包含其許可條款。

參考資料

• Spring AI文檔
• 模型上下文協議
• CoinGecko API