Kotlin Cyrpto Price Spring MCP Server Demo
Kotlin Spring AI MCP server demo. Getting Cryptocurrency pricing from Binance
Ask AI about Kotlin Cyrpto Price Spring MCP Server Demo
Powered by Claude Β· Grounded in docs
I know everything about Kotlin Cyrpto Price Spring MCP Server Demo. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Kotlin Crypto Price Spring MCP Server Demo
A demonstration project showcasing the integration of Spring AI's Model Context Protocol (MCP) server with a cryptocurrency price API service. This project allows AI models to retrieve real-time cryptocurrency information through a standardized interface.
Overview
This project implements a Spring Boot application that serves as an MCP server, providing tools for AI models to:
- Search for cryptocurrencies by name or symbol
- Retrieve market data for specific cryptocurrencies
The application uses the CoinGecko API to fetch real-time cryptocurrency data.
Features
- Cryptocurrency Search: Search for cryptocurrencies, exchanges, categories, and NFTs
- Market Data Retrieval: Get detailed market data for specific cryptocurrencies
- MCP Integration: Exposes functionality as tools for AI models via Spring AI's MCP server
- Logging: Comprehensive logging of tool requests and responses
Technologies
- Kotlin 1.9.25
- Spring Boot 3.4.4
- Spring AI MCP Server
- Model Context Protocol SDK 0.8.1
- Java 21
Project Structure
src/main/kotlin/org/gaplo917/mcpservercoinprice/
βββ CoinPriceService.kt # Service for cryptocurrency data retrieval
βββ McpServerCoinPriceApplication.kt # Main application class
Getting Started
Prerequisites
- JDK 21 or higher
- Gradle
Running the Application
./gradlew bootRun
The MCP server will start on the default port (typically 8080).
API Tools
The application exposes the following tools for AI models:
1. Search Cryptocurrency
@Tool(description = "search cryptocurrency information by user input query.")
fun searchCryptocurrency(query: String): CryptoData
2. Get Market Data
@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
Data Models
CryptoData: Contains lists of coins, exchanges, categories, and NFTsCryptoMarketData: Contains market data including tickers for a specific cryptocurrencyCoin: Represents a cryptocurrency with its ID, name, symbol, and market cap rankTicker: Contains trading information for a cryptocurrency on a specific market
Integration with AI Models
This server can be used with AI models that support the Model Context Protocol (MCP), allowing them to retrieve cryptocurrency data in a standardized way. The Spring AI MCP Server handles the communication between the AI model and the cryptocurrency service.
License
This project is licensed under the terms included in the LICENSE file.
