Kotlin Crypto Price Spring MCP Server Demo

基本能力

产品定位

该项目是一个 Spring Boot 应用程序，作为 MCP 服务器，为 AI 模型提供工具，用于检索实时加密货币信息。

核心功能

• 加密货币搜索：通过名称或符号搜索加密货币、交易所、类别和 NFT。
• 市场数据检索：获取特定加密货币的详细市场数据。
• MCP 集成：通过 Spring AI 的 MCP 服务器将功能暴露为 AI 模型的工具。
• 日志记录：全面记录工具请求和响应的日志。

适用场景

• AI 模型需要实时加密货币数据时。
• 需要标准化接口来获取加密货币信息的场景。

工具列表

1. Search Cryptocurrency：
2. 功能：根据用户输入查询搜索加密货币信息。

3. 代码示例： kotlin @Tool(description = "search cryptocurrency information by user input query.") fun searchCryptocurrency(query: String): CryptoData

4. Get Market Data：

5. 功能：通过 ID 获取加密货币市场数据。ID 必须来自 searchCryptocurrency 工具的返回。
6. 代码示例： kotlin @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

常见问题解答

• 如何运行应用程序？

• 使用命令 ./gradlew bootRun 启动 MCP 服务器，默认端口为 8080。

• 数据来源是什么？

• 使用 CoinGecko API 获取实时加密货币数据。

使用教程

使用依赖

• JDK 21 或更高版本
• Gradle

安装教程

1. 确保已安装 JDK 21 和 Gradle。
2. 克隆项目到本地。
3. 在项目根目录下运行以下命令启动应用程序： bash ./gradlew bootRun

调试方式

• 启动应用程序后，可以通过访问默认端口（8080）来验证服务是否正常运行。
• 查看日志以确认工具请求和响应的记录。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。