gokub-mcp

dvgamerr-app/gokub-mcp

3.2

If you are the rightful owner of gokub-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Bitkub MCP Server is a Model Context Protocol server designed for seamless integration with the Bitkub Cryptocurrency Exchange API, providing real-time communication and secure authentication.

Tools
5
Resources
0
Prompts
0

🚀 Bitkub MCP Server

CodeQL Go Version Discord

Model Context Protocol server for Bitkub Cryptocurrency Exchange API

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

logo

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
EndpointPurposeMethod
http://localhost:8080Main URLGET
http://localhost:8080/sseSSE ConnectionGET
http://localhost:8080/messageSend MessagePOST

🛠️ Available Tools

  1. get_wallet_balance
  2. get_ticker
  3. get_market_depth
  4. get_my_open_orders
  5. 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

CategoryRate LimitNote
📈 Market Data100 req/secPublic endpoints
💱 Trading Operations150-200 req/secAuthenticated 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

Discord

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