my-crypto-mcp

My Crypto MCP

This Model Context Protocol (MCP) server provides cryptocurrency information through Claude Desktop. It connects to the CoinMarketCap API to fetch real-time cryptocurrency data.

Features

• Get current cryptocurrency information by symbol
• View a sample cryptocurrency portfolio

Prerequisites

• Claude Desktop
• Node.js (v16 or later)
• CoinMarketCap API key (get one at coinmarketcap.com/api)

Setup Instructions

1. Install Dependencies

npm install

2. Build the Project

npm run build

3. Configure Claude Desktop

Add the MCP server to Claude Desktop by editing the Claude configuration file:

1. Open Claude Desktop settings
2. Add the following configuration:

{
  "mcpServers": {
    "crypto": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/build/index.js"],
      "env": {
        "CMC_API_KEY": "your-coinmarketcap-api-key"
      }
    }
  }
}

Important: Replace /absolute/path/to/your/project with the actual path to your project directory and your-coinmarketcap-api-key with your actual CoinMarketCap API key.

4. Restart Claude Desktop

After adding the configuration, restart Claude Desktop to load the MCP server.

Using the Crypto MCP

Once configured, you can use the following commands in your chat with Claude:

Get Portfolio Information

1. Add Portfolio Resource

Attach portfolio resource from the MCP using the attachment button in Claude Desktop.

2. Ask your own questions

You can now ask questions like:

What is my portfolio's current value?

Claude will fetch the latest information from the CoinMarketCap API and provide detailed information about your portfolio.

Example Response

Here's a sample of what Claude might return:

Based on your portfolio and current market prices, here's the value of your cryptocurrency holdings as of April 27, 2025:

ZK (ZKsync): 69,696 ZK × $0.06051 = $4,217.48
Bitcoin (BTC): 9,696 BTC × $94,361.18 = $914,904,201.28
Ethereum (ETH): 23,456 ETH × $1,803.33 = $42,288,825.48

Total portfolio value: $957,197,244.24
Your portfolio is primarily dominated by your Bitcoin holdings, which represent over 95% of your total portfolio value. Would you like any additional information about market trends or recommendations for your portfolio?

Development

• Source code is in the src directory
• The main MCP server is defined in index.ts
• API interactions are handled in helper.ts

Troubleshooting

If you encounter issues:

1. Check that your CoinMarketCap API key is valid
2. Verify the path to the build file in Claude Desktop configuration
3. Check console output for any error messages