Quick Start

This guide will help you set up ByteMCP and start querying Bitcoin ATM locations through AI assistants.

Prerequisites

• Node.js 18+
• MySQL database with ATM location data
• Claude Desktop (for local testing)

Installation

1. Clone the Repository

git clone https://github.com/bytefederal/byte-mcp.git
cd byte-mcp

2. Install Dependencies

npm install

3. Configure Environment

Create a .env file:

cp .env.example .env

Edit .env with your database credentials:

DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=bytefederal
DB_USER=your_username
DB_PASSWORD=your_password

4. Build the Project

npm run build

5. Test Locally

Run the server in stdio mode:

npm start

Add to Claude Desktop

Edit your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "bytefederal-atm": {
      "command": "node",
      "args": ["/path/to/byte-mcp/dist/index.js"],
      "env": {
        "DB_HOST": "your_db_host",
        "DB_DATABASE": "bytefederal",
        "DB_USER": "your_user",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

Restart Claude Desktop after saving.

Try It Out

Open Claude Desktop and try these queries:

• “Find Bitcoin ATMs near Miami, FL”
• “What are the hours for the ATM at ID 123?”
• “Are there any open ATMs in New York City right now?”
• “List all Bitcoin ATMs in Austin, Texas”

Verify Installation

Check if the MCP server is recognized:

1. Open Claude Desktop
2. Look for the MCP tools icon (hammer/wrench)
3. Click to see available tools
4. You should see the 4 ByteMCP tools listed

Troubleshooting

Server Not Starting

Check your database connection:

# Test MySQL connection
mysql -h $DB_HOST -u $DB_USER -p$DB_PASSWORD $DB_DATABASE -e "SELECT 1"

Tools Not Appearing

1. Verify the path in claude_desktop_config.json is correct
2. Ensure the project is built (npm run build)
3. Check Claude Desktop logs for errors
4. Restart Claude Desktop

Permission Denied

Make sure the entry point is executable:

chmod +x dist/index.js

Next Steps

• Configuration - Advanced configuration options
• MCP Tools - Learn about each tool
• Deployment - Deploy for production use