Kotlin Crypto Price Spring MCP Server Demo

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

一个演示项目，展示如何将 Spring AI 的 Model Context Protocol（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 服务
• Model Context Protocol SDK 0.8.1
• Java 21

项目结构

src/main/kotlin/org/gaplo917/mcpservercoinprice/
├── CoinPriceService.kt         # Service for cryptocurrency data retrieval
├── McpServerCoinPriceApplication.kt  # Main application class

开始使用

前提条件

• 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：包含币种、交易所、类别和 NFT 列表
• CryptoMarketData：包含特定加密货币的市场数据，包括行情报价
• Coin：表示一种加密货币，包含其 ID、名称、代码和市值排名
• Ticker：包含加密货币在特定市场上的交易信息

与 AI 模型集成

该服务可供支持 Model Context Protocol（MCP）的 AI 模型使用，使其能够以标准化方式获取加密货币数据。Spring AI MCP 服务负责处理 AI 模型与加密货币服务之间的通信。

许可证

本项目遵循 LICENSE 文件中所含条款授权。

参考资料

• Spring AI 文档
• Model Context Protocol
• CoinGecko API