Luno MCP

🚀 Luno MCP 服務器

Luno MCP 服務器是一個 模型上下文協議（MCP）服務器，它提供對 Luno 加密貨幣交易平臺 API 的訪問。該服務器支持與 VS Code 的 Copilot 以及其他 MCP 兼容客戶端集成，為 Luno 加密貨幣交易提供上下文信息和相關功能。

🚀 快速開始

本項目是一個 MCP 服務器，可提供對 Luno 加密貨幣交易平臺 API 的訪問。要使用該服務器，你需要完成以下步驟：

1. 從 Luno 賬戶設置中獲取 API 密鑰和密鑰密碼，具體可參考 https://www.luno.com/developers。
2. 根據需求選擇合適的安裝方式，如從源代碼構建或使用 Docker 安裝。
3. 配置服務器的命令行選項，如傳輸類型、日誌級別等。

✨ 主要特性

• 資源訪問：可訪問賬戶餘額、交易歷史等信息。
• 工具功能：具備創建和管理訂單、查詢價格、查看交易詳情等功能。
• 安全認證：使用 Luno API 密鑰進行安全認證。
• VS Code 集成：可輕鬆與 VS Code 的 Copilot 功能集成。

⚠️ 重要提示

本項目目前處於 測試階段。儘管我們已盡力確保其穩定性和可靠性，但你仍可能遇到意外行為或限制。請謹慎使用，並考慮以下幾點：

• 此 MCP 服務器配置可能會在未提前通知的情況下更改。
• 性能和可靠性可能並非最優。
• 並非所有 Luno API 端點都已實現。

我們歡迎反饋和錯誤報告，以幫助改進項目。若遇到任何問題，請通過 GitHub 問題跟蹤器 報告。

📦 安裝指南

前提條件

• Go 1.24 或更高版本
• 擁有 Luno 賬戶，並獲取 API 密鑰和密鑰密碼

從源代碼構建

1. 克隆倉庫：

git clone https://github.com/luno/luno-mcp
cd luno-mcp

2. 構建二進制文件：

go build -o luno-mcp ./cmd/server

3. （可選）將其設置為系統全局可用：

sudo mv luno-mcp /usr/local/bin/

💻 使用示例

基礎用法

查看錢包餘額

你可以讓 Copilot 顯示你的錢包餘額：

What are my current wallet balances on Luno?

交易操作

你可以讓 Copilot 幫助你進行交易：

Create a limit order to buy 0.001 BTC at 50000 ZAR

查看交易歷史

你可以讓 Copilot 顯示你的交易歷史：

Show me my recent Bitcoin transactions

查看市場數據

你可以讓 Copilot 顯示市場數據：

Show me recent trades for XBTZAR

What's the latest price for Bitcoin in ZAR?

高級用法

VS Code 集成

要與 VS Code 集成，可將以下內容添加到你的 settings.json 文件中（或點擊本 README 頂部的徽章獲取 Docker 配置）。

使用 Docker

此配置將使 VS Code 運行 Docker 容器。請確保你的系統上已運行 Docker。

"mcp": {
  "servers": {
    "luno-docker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=${input:luno_api_key_id}",
        "-e", "LUNO_API_SECRET=${input:luno_api_secret}",
        // 可選：傳遞 LUNO_API_DEBUG=true
        // "-e", "LUNO_API_DEBUG=true",
        "ghcr.io/luno/luno-mcp:latest"
        // 可選：向 luno-mcp 傳遞額外參數
        // "--log-level", "debug"
      ],
      "inputs": [
         {"id": "luno_api_key_id", "type": "promptString", "description": "Luno API Key ID", "password": true},
         {"id": "luno_api_secret", "type": "promptString", "description": "Luno API Secret", "password": true}
      ]
    }
  }
}

從源代碼構建

除了添加上述配置選項外，你還需要按照以下說明進行操作。

對於 stdio 傳輸

"mcp": {
  "servers": {
    "luno": {
      "command": "luno-mcp",
      "args": [],
      "env": {
        "LUNO_API_KEY_ID": "${env:LUNO_API_KEY_ID}",
        "LUNO_API_SECRET": "${env:LUNO_API_SECRET}"
      }
    }
  }
}

對於 SSE 傳輸

"mcp": {
  "servers": {
    "luno": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

📚 詳細文檔

命令行選項

• --transport：傳輸類型（stdio 或 sse，默認：stdio）
• --sse-address：SSE 傳輸地址（默認：localhost:8080）
• --domain：Luno API 域名（默認：api.luno.com）
• --log-level：日誌級別（debug、info、warn、error，默認：info）

可用工具

🔧 技術細節

測試

項目包含單元測試和集成測試。單元測試無需任何憑證即可運行，而集成測試需要 Luno API 憑證。

# 僅運行單元測試
go test -v ./... -short

# 運行集成測試（需要 API 憑證）
go test -v ./internal/tests -run "Integration" -skip=""

GitHub Actions

本倉庫配置了 GitHub Actions 進行持續集成測試：

1. 單元測試：在所有推送到主分支的事件和拉取請求上自動運行。
2. 集成測試：可在 GitHub Actions 選項卡中使用“手動集成測試”工作流手動運行。

要使集成測試在 GitHub Actions 中正常工作，你需要在倉庫中設置以下機密信息：

• LUNO_API_KEY：你的 Luno API 密鑰
• LUNO_API_SECRET：你的 Luno API 密鑰密碼
• RUN_INTEGRATION_TESTS：設置為任何非空值以在主分支上啟用集成測試

集成測試僅在顯式觸發或在主分支上配置時運行。

貢獻代碼

如果你想為該項目的開發做出貢獻，請參閱 CONTRIBUTING.md 文件獲取指南。

📄 許可證

本項目採用 MIT 許可證。