CoinGecko Price Server

A simple Model Context Protocol (MCP) server that provides cryptocurrency pricing information using the CoinGecko API.

Features

• get_crypto_price: A tool to fetch the current price of a cryptocurrency in a specific currency.
  • Inputs:
    • crypto_id: The CoinGecko ID of the cryptocurrency (e.g., 'bitcoin', 'ethereum').
    • currency: The target currency for the price (e.g., 'usd', 'brl').

Prerequisites

• Node.js (v18 or higher recommended)
• npm

Installation

1. Clone or navigate to the project repository.

2. Install dependencies:

   npm install
   

Building the Project

Compile the TypeScript code to JavaScript:

npm run build

The compiled output will be in the dist directory.

Usage

Testing Locally with MCP Inspector (The npx Way)

You can test the server interactively using the MCP Inspector. This allows you to inspect tools and resources and make tool calls directly.

1. Build the project first:

   npm run build
   

2. Run the inspector using npx, pointing it to your built server script:

   npx @modelcontextprotocol/inspector node dist/index.js
   

   Note: On Windows, use a full path or ensuring valid path syntax if you encounter issues.

3. Open the URL provided in the terminal (usually http://localhost:5173) to interact with your server.

Running Directly

You can run the server directly (it communicates via Stdio), but it is designed to be used by an MCP client (like Claude Desktop or the Inspector).

npm start

Developing

To run the server in development mode (using tsx):

npm run dev

Setup with Claude Desktop

To use this server with Claude Desktop apps:

1. Locate your Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

   {
     "mcpServers": {
       "coingecko_price": {
         "command": "node",
         "args": ["/absolute/path/to/mcp_coingecko_price_ts/dist/index.js"]
       }
     }
   }
   

   Remember to run npm run build after making changes to the source code.

3. You can run this mcp with stdio transport using npx command

   {
    "mcpServers": {
      "coingecko_price": {
        "command": "npx",
        "args": ["-y", "mcp_coingecko_price_ts"]
      }
    }
   }