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.

This project implements a Spring Boot application that serves as an MCP server, providing tools for AI models to:

1. Search for cryptocurrencies by name or symbol
2. Retrieve market data for specific cryptocurrencies

The application uses the CoinGecko API to fetch real-time cryptocurrency data.

• 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

• 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         # Service for cryptocurrency data retrieval
├── McpServerCoinPriceApplication.kt  # Main application class

• JDK 21 or higher
• Gradle

./gradlew bootRun

The MCP server will start on the default port (typically 8080).

The application exposes the following tools for AI models:

@Tool(description = "search cryptocurrency information by user input query.")
fun searchCryptocurrency(query: String): CryptoData

@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: Contains lists of coins, exchanges, categories, and NFTs
• CryptoMarketData: Contains market data including tickers for a specific cryptocurrency
• Coin: Represents a cryptocurrency with its ID, name, symbol, and market cap rank
• Ticker: Contains trading information for a cryptocurrency on a specific market

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.

This project is licensed under the terms included in the LICENSE file.

• Spring AI Documentation
• Model Context Protocol
• CoinGecko API