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