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
• 模型上下文协议 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 = "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: 包含 coins、exchanges、categories 和 NFTs 的列表
• CryptoMarketData: 包含特定加密货币的市场数据，包括 tickers
• Coin: 代表一种加密货币，包含其 ID、名称、符号和市值排名
• Ticker: 包含特定市场上加密货币的交易信息

与 AI 模型集成

该服务器可以与支持模型上下文协议 (MCP) 的 AI 模型一起使用，允许它们以标准化方式检索加密货币数据。 Spring AI MCP Server 处理 AI 模型和加密货币服务之间的通信。

许可证

该项目根据 LICENSE 文件中包含的条款获得许可。

参考

• Spring AI 文档
• 模型上下文协议
• CoinGecko API