whitmanca/mcp-crypto-price

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

1. Clone the repository:

git clone <your-repo-url>
cd <your-repo-name>

2. Install dependencies with uv:

uv sync

Testing with MCP Inspector

The MCP Inspector allows you to test your server locally before integrating with Claude.

1. Install the MCP Inspector:

npm install -g @modelcontextprotocol/inspector

2. Run your server with the inspector:

npx @modelcontextprotocol/inspector uv run server.py

3. Open the web interface that appears (usually http://localhost:5173)

4. Test the tools:

   • Try get_crypto_price_by_name with coin_name: "Bitcoin"
   • Try get_crypto_price_by_symbol with coin_symbol: "BTC"

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.py directly 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)