Kotlin Cyrpto Price Spring MCP Server Demo

A demonstration project of a cryptocurrency price query MCP service based on Spring Boot and Kotlin, integrating the CoinGecko API to provide real-time cryptocurrency data retrieval functionality.

Finance Developer tools #Cryptocurrency #MCP Service #Spring AI #Real-time Data .kotlin

rating : 2 points

downloads : 6.6K

update time : 2025-04-29

Open Site

What is the Kotlin Crypto Price MCP Server?

The Kotlin Crypto Price MCP Server is a tool based on Spring Boot. By integrating the CoinGecko API, it provides real-time cryptocurrency price query functionality for AI models. It supports functions such as searching for cryptocurrencies and obtaining market data, helping users quickly understand the latest trends of cryptocurrencies.

How to use the Kotlin Crypto Price MCP Server?

Simply start the server and call the corresponding API interfaces to obtain relevant information about cryptocurrencies through the AI model. No complex configuration is required, and the operation is simple and efficient.

Applicable Scenarios

Suitable for investment institutions and individual investors who need to monitor cryptocurrency prices in real-time, as well as AI applications that need to integrate cryptocurrency data.

Main Features

Cryptocurrency Search

Quickly find cryptocurrency information by entering keywords (such as name or symbol).

Market Data Analysis

Obtain detailed market data, including price trends and trading volumes, based on a specific cryptocurrency ID.

Multi-language Support

Supports API calls in multiple languages, facilitating international use.

Advantages

Real-time data updates ensure information accuracy.

Easy to integrate into existing systems, reducing development costs.

Supports multiple query methods to meet diverse needs.

Free and open source, with active community support.

Limitations

Depends on external API services, and network interruptions may affect functionality.

Data accuracy is limited by third-party APIs.

Limited support for large-scale concurrent requests.

How to Use

Download and Install

Clone the project code and use the Gradle build tool for compilation and running.

Start the Server

After starting, it listens on port 8080 by default, which can be modified through the configuration file.

Call API Interfaces

Call the `searchCryptocurrency` or `getMarketDataByCryptocurrencyId` interfaces by sending HTTP requests.

Usage Examples

Example 1: Query Cryptocurrency Price

The user enters the keyword 'ethereum', and the server returns the current market price of this cryptocurrency.

Example 2: Obtain Market Data Analysis

The user enters the specific ID 'bitcoin', and the server returns the detailed market data of Bitcoin.

Frequently Asked Questions

How to start the Kotlin Crypto Price MCP Server?

Does it support multi-language queries?

How to handle network interruption issues?

Related Resources

GitHub Repository

Project source code address.

CoinGecko API Documentation

Third-party API documentation.

Spring AI Official Documentation

Materials related to the MCP protocol.

🚀 Kotlin Cryptocurrency 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 obtain real-time cryptocurrency information through a standardized interface.

🚀 Quick Start

Prerequisites

JDK 21 or higher
Gradle

Running the Application

./gradlew bootRun

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

✨ Features

Cryptocurrency Search: Query cryptocurrencies, exchanges, categories, and NFTs based on user input.
Market Data Retrieval: Obtain detailed market information for specific cryptocurrencies.
MCP Integration: Expose functions as tools for AI models via Spring AI's MCP server.
Logging: Thoroughly log tool requests and responses.

📦 Installation

Prerequisites

JDK 21 or higher
Gradle

Steps

./gradlew bootRun

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

💻 Usage Examples

Basic Usage

The application exposes the following tools to AI models:

1. Search Cryptocurrency

@Tool(description = "Search for cryptocurrency information based on the user's input query.")
fun searchCryptocurrency(query: String): CryptoData

2. Get Market Data

@Tool(description = "Get the market data of a cryptocurrency based on its ID. This ID must be provided by the return value of the searchCryptocurrency tool.")
fun getMarketDataByCryptocurrencyId(id: String): CryptoMarketData

📚 Documentation

Overview

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

Search for cryptocurrencies by name or symbol.
Obtain market data for specific cryptocurrencies. The application uses the CoinGecko API to fetch real-time cryptocurrency data.

Project Structure

src/main/kotlin/org/gaplo917/mcpservercoinprice/
├── CoinPriceService.kt         # Cryptocurrency data retrieval service
├── McpServerCoinPriceApplication.kt  # Main application class

Data Models

CryptoData: Contains lists of cryptocurrencies, exchanges, categories, and NFTs.
CryptoMarketData: Contains market information for a specific cryptocurrency, including trading pairs.
Coin: Represents a cryptocurrency with its ID, name, symbol, and market cap rank.
Ticker: Contains trading information for a cryptocurrency in 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 manner. The Spring AI MCP Server handles communication between the AI model and the cryptocurrency service.