MCP Server
A Model Context Protocol server that provides crypto price fetching capabilities. This server enables LLMs to retrieve and process the latest price for any coin by its name or symbol. This server was created for demo and practice purposes only and has limited capabilities.
Rate Limits: This server utilizes CoinGecko's free Demo API plan which has a rate limit of approximately 30 calls per minute.
Available Tools
get_crypto_price_by_name- Fetches the current price for a coin by coin name.coin_name(string, required): The name of the coin (e.g. Bitcoin)
get_crypto_price_by_symbol- Fetches the current price for a coin by coin symbol.coin_symbol(string, required): The symbol of the coin (e.g. BTC)
Setup
Prerequisites
- Python 3.8+
- uv package manager
Installation
- Clone the repository:
git clone <your-repo-url>
cd <your-repo-name>
- Install dependencies with uv:
uv sync
Testing with MCP Inspector
The MCP Inspector allows you to test your server locally before integrating with Claude.
- Install the MCP Inspector:
npm install -g @modelcontextprotocol/inspector
- Run your server with the inspector:
npx @modelcontextprotocol/inspector uv run server.py
-
Open the web interface that appears (usually
http://localhost:5173) -
Test the tools:
- Try
get_crypto_price_by_namewithcoin_name: "Bitcoin" - Try
get_crypto_price_by_symbolwithcoin_symbol: "BTC"
- Try
Claude Desktop Integration
1. Find Your Config File
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
2. Add Server Configuration
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"crypto-price-server": {
"command": "uv",
"args": ["run", "/absolute/path/to/your/server.py"],
"cwd": "/absolute/path/to/your/project/directory"
}
}
}
Replace the paths with your actual project paths.
3. Restart Claude Desktop
Close and reopen Claude Desktop completely.
4. Test in Claude
Ask Claude something like:
- "What's the current price of Bitcoin?"
- "Can you get the price of ETH using the crypto tools?"
- "Use the crypto price tool to check the price of Solana"
Troubleshooting
Server won't start:
- Make sure you're in the project directory
- Try
uv run server.pydirectly to see error messages
Claude can't find the server:
- Double-check the absolute paths in your config
- Make sure there are no typos in the JSON
- Restart Claude Desktop after making changes
Tools return errors:
- Check your internet connection
- You may have hit the CoinGecko rate limit (wait a minute and try again)