💰

Gokub MCP

Name: Gokub MCP
Rating: 2.9 (1 reviews)
Author: dvgamerr-app

🚀 Model Context Protocol (MCP) server for Bitkub Cryptocurrency Exchange API - Connect Claude Desktop with Bitkub trading platform using Go

0 installs

1 stars

2 forks

Trust: 58 — Fair

Finance

Installation

npx gokub-mcp

Ask AI about Gokub MCP

I know everything about Gokub MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

🚀 Bitkub MCP Server

Model Context Protocol server for Bitkub Cryptocurrency Exchange API

เชื่อมต่อ Claude Desktop กับ Bitkub Exchange ผ่าน MCP Protocol

Features • Installation • API Tools • Configuration • Community

✨ Features

🎯 Core Features

✅ MCP Server - Built with mcp-go
🌐 HTTP/SSE - Real-time communication
🔐 Secure - HMAC SHA256 signature
💰 Wallet - View balances & transactions

🚀 Developer Experience

💎 Go-Bitkub SDK - Full API v3 support
🧠 Integration - with Claude Desktop
📊 Market Data - Real-time ticker & depth
📖 Order - Track open orders

🔧 Installation

Quick Start

# 1️⃣ Clone repository
git clone https://github.com/dvgamerr-app/gokub-mcp.git
cd gokub-mcp

# 2️⃣ Install dependencies
go mod download

# 3️⃣ Create .env file
echo "BTK_APIKEY=your_api_key_here" > .env
echo "BTK_SECRET=your_secret_key_here" >> .env

# 4️⃣ Run server
go run main.go

🏗️ Build Executable

# Windows
go build -o bitkub-mcp.exe
./bitkub-mcp.exe

# Linux/Mac
go build -o bitkub-mcp
./bitkub-mcp

🎮 Usage

HTTP/SSE Server Mode

# Default port 8080
go run main.go

# Custom port
PORT=3000 go run main.go

📡 Server Endpoints

Endpoint	Purpose	Method
`http://localhost:8080`	Main URL	GET
`http://localhost:8080/sse`	SSE Connection	GET
`http://localhost:8080/message`	Send Message	POST

🛠️ Available Tools

get_wallet_balance
get_ticker
get_market_depth
get_my_open_orders
get_symbols

⚙️ Configuration

🔐 API Keys Setup

สร้างไฟล์ .env ใน root directory:

BTK_APIKEY=your_api_key
BTK_SECRET=your_secret_key

🤖 Claude Desktop Integration

HTTP/SSE Mode (แนะนำ)

เพิ่มการตั้งค่าใน Claude Desktop config:

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

{
  "mcpServers": {
    "bitkub": {
      "url": "http://localhost:8080/sse",
      "transport": "sse"
    }
  }
}

Stdio Mode (Legacy)

{
  "mcpServers": {
    "bitkub": {
      "command": "e:\\.dvgamerr\\gokub-mcp\\bitkub-mcp.exe",
      "env": {
        "BTK_APIKEY": "your_api_key",
        "BTK_SECRET": "your_secret_key"
      }
    }
  }
}

⚠️ หมายเหตุ: ควรตั้งค่า API keys ผ่าน environment variables แทนการใส่ใน config file

📁 Project Structure

gokub-mcp/
├── 📄 main.go              # MCP Server entry point (HTTP/SSE)
├── 📂 prompts/             # Trading prompts
├── 📂 resources/           # Market resources
├── 📂 tools/               # MCP tools implementation
└── 📂 utils/               # Utility functions

📊 API Rate Limits

Category	Rate Limit	Note
📈 Market Data	100 req/sec	Public endpoints
💱 Trading Operations	150-200 req/sec	Authenticated endpoints

📚 Bitkub API Docs สำหรับข้อมูลเพิ่มเติม

🚀 Roadmap

✅ Completed

Bitkub API golang library
MCP Server implementation
HTTP/SSE transport
Basic wallet & market tools

🚧 In Progress

Rebalancing Bot
Grid Trading strategy
Advanced order management

🎯 Planned Features

Docker Image support
Kubernetes deployment
WebSocket real-time data
Trading bot framework

📚 References

🔧 MCP-Go Framework

💎 Go-Bitkub SDK

📖 Bitkub Official API Docs

🤖 Protocol MCP Spec

👥 Community

Join our community to discuss, get help, and share your trading strategies!

Made with ❤️ by dvgamerr-app

⭐ Star this repo if you find it helpful!

Report Bug • Request Feature • Contribute