Binance MCP Server (TypeScript)

A TypeScript implementation of the Model Context Protocol (MCP) server for Binance cryptocurrency data.

Features

🔧 Tools

• get_price: Get current cryptocurrency price from Binance
• get_price_change: Get 24-hour price change statistics

📁 Resources

• activity.log: Server activity and request logs
• symbol_map.csv: Cryptocurrency name to symbol mappings

💬 Prompts

• executive_summary: Get Bitcoin and Ethereum market analysis
• crypto_summary: Get specific cryptocurrency market analysis

Quick Start

1. Install Dependencies

npm install

2. Build

npm run build

3. Run the Server

node dist/binance_mcp.js

Usage

With MCP Inspector

npx @modelcontextprotocol/inspector node dist/binance_mcp.js

In Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "binance": {
      "command": "node",
      "args": ["C:\\MCP\\typescript_mcp\\dist\\binance_mcp.js"]
    }
  }
}

Supported Symbols

The server supports name-to-symbol mapping for:

• Bitcoin (BTC) → BTCUSDT
• Ethereum (ETH) → ETHUSDT
• Cardano (ADA) → ADAUSDT
• Solana (SOL) → SOLUSDT

You can also use any Binance trading pair directly (e.g., "BNBUSDT", "DOGEUSDT").

Example Queries

When connected to an MCP client:

"What is the current price of Bitcoin?"
"Get the 24-hour price change for ETHUSDT"
"Show me the executive summary"
"Give me a crypto summary for Solana"

Project Structure

typescript_mcp/
├── binance_mcp.ts       # Main server implementation
├── dist/                # Compiled JavaScript output
├── package.json         # Dependencies and scripts
├── tsconfig.json        # TypeScript configuration
└── README.md           # This file

Development

Build

npm run build

Type Checking

npx tsc --noEmit

API Endpoints

The server uses Binance public APIs:

• Price: https://api.binance.us/api/v3/ticker/price
• 24h Stats: https://data-api.binance.vision/api/v3/ticker/24hr

No API key required for basic price data.

Requirements

• Node.js >= 16.0.0
• npm or yarn

License

MIT