szcharlesji_crypto mcp

# Crypto MCP

A [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides Claude AI with real-time access to cryptocurrency data from the CoinMarketCap API.

## Features

This server provides the following tools to Claude:

- **get-cryptocurrency-listings**: Get the latest cryptocurrency market data
- **get-cryptocurrency-quotes**: Retrieve quotes for specific cryptocurrencies
- **get-cryptocurrency-map**: Fetch the mapping of cryptocurrencies to CoinMarketCap IDs
- **get-cryptocurrency-info**: Get detailed metadata for specific cryptocurrencies
- **get-global-metrics**: Access global cryptocurrency market metrics
- **get-exchange-listings**: Get information about cryptocurrency exchanges

## Prerequisites

- A CoinMarketCap API key (get one at [pro.coinmarketcap.com](https://pro.coinmarketcap.com))

## Integration with Claude Desktop

To integrate this MCP server with Claude Desktop:

1. Locate the Claude Desktop configuration file:

    - On macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`

2. Add the following configuration to the file:

```json
{
    "mcpServers": {
        "cmc": {
            "command": "npx",
            "args": ["crypto-mcp"],
            "env": {
                "COINMARKET_API_KEY": "your-api-key-here"
            }
        }
    }
}
```

## Manual Installation

1. Clone this repository
2. Install dependencies:

```bash
# Using npm
npm install

# Using bun
bun install
```

3.  Build the TypeScript code:

```bash
# Using npm
npm run build

# Using bun
bun run build
```

## Usage in Claude

Once configured, you can ask Claude to perform various cryptocurrency-related tasks:

- "Show me the top 10 cryptocurrencies by market cap"
- "What's the current price of Bitcoin and Ethereum?"
- "What are the global cryptocurrency market metrics today?"
- "Tell me about the Binance exchange"

## Screenshots

### Top Cryptocurrencies

![Top Cryptocurrencies](assets/top.png)

### Cryptocurrency Metadata

![Cryptocurrency Metadata](assets/metadata.png)

### Market Metrics

![Market Metrics](assets/market_metrics.png)

## Development

This project uses TypeScript and the Model Context Protocol SDK to build a server that communicates with Claude AI.

To modify the available tools or add new endpoints, edit the `src/index.ts` file and rebuild the project.