spring-boot-bitcoin -2025

This Bitcoin MCP Server is a Spring Boot/AI-powered MCP server that demonstrates tracking Bitcoin prices using CoinGecko APIs. It can be integrated with Claude Desktop to enable conversational access to real-time price data and simple price queries via the MCP protocol. Once running, you can query current Bitcoin prices, price changes over time, and related market data that the server exposes through its MCP interfaces. The Claude-generated client integration described in the README shows how to connect the server to Claude Desktop, enabling you to trigger price retrieval from natural language prompts and workflows.

To use the server with Claude Desktop, configure the MCP server in Claude Desktop settings with the provided JSON snippet, pointing to the locally or remotely hosted jar you built. After starting the server, Claude can send structured MCP requests to fetch prices, and the server will respond with the latest Bitcoin data sourced from CoinGecko.

Prerequisites:\n- Java 17 or later\n- Gradle wrapper (used by the project) or a compatible Java build environment\n- Claude Desktop installed with a Claude Account (for integration)\n\nInstallation steps:\n1) Clone the repository or obtain the MCP server jar built from the repository.\n2) Ensure Java 17+ is installed and accessible in your PATH.\n3) Build the project (as per the repository):\n\nbash\n./gradlew clean build -x test\n\n4) Locate the generated jar, e.g.: bitcoin-mcp-server-0.0.1-SNAPSHOT.jar.\n5) Run the server locally: java -jar /path/to/bitcoin-mcp-server-0.0.1-SNAPSHOT.jar\n6) (Optional) Configure Claude Desktop integration with the provided JSON configuration.\n\nNotes:\n- The server relies on CoinGecko APIs for price data, which are publicly accessible without an API key for basic queries.\n- If running behind a firewall, ensure outbound access to CoinGecko endpoints and any configured port is allowed.\n

Tips and considerations:\n- Ensure the Java process has sufficient memory for running Spring Boot and any AI components.\n- When configuring Claude Desktop, use an absolute path to the jar as shown in the example to avoid classpath issues.\n- If you encounter API rate limits from CoinGecko, consider caching responses server-side or implementing minimal backoff strategies.\n- The example configuration uses a single MCP server named bitcoin-mcp-server; you can adjust the name as needed in Claude Desktop.\n- Monitor logs for any initialization errors related to the CoinGecko client or the Spring context.\n