Kotlin加密货币价格Spring MCP服务器演示

一个展示Spring AI的模型上下文协议（MCP）服务器与加密货币价格API服务集成的示范项目。该项目允许AI模型通过标准化接口获取实时加密货币信息。

概述

该项目实现了一个Spring Boot应用程序，作为MCP服务器，提供工具让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

项目结构

src/main/kotlin/org/gaplo917/mcpservercoinprice/
├── CoinPriceService.kt         # 加密货币数据检索服务
├── McpServerCoinPriceApplication.kt  # 主应用程序类

入门指南

前提条件

• JDK 21或更高版本
• Gradle

运行应用程序

./gradlew bootRun

MCP服务器将在默认端口（通常为8080）启动。

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