mcpField
L
Luno MCP Server

Luno MCP Server

ローカル
github.com/luno金融データ285 週間前に更新
リポジトリ

Luno MCP Server について

Luno MCP Server は、暗号資産取引所 Luno の API に接続するMCP サーバーです。Claude Code、VS Code、Cursor などのMCP クライアントから、相場情報、残高、取引履歴を確認できます。注文などの書き込み操作は明示的に有効化した場合のみ利用できます。

主な機能

  1. 01ティッカー、板情報、約定履歴、ローソク足データの取得
  2. 02アカウント残高と取引明細の確認
  3. 03有効化時のみ注文作成、キャンセル、通貨交換に対応
  4. 04デフォルトは読み取り専用、書き込みには明示的な設定が必要
  5. 05stdio と SSE のトランスポートに対応

活用シーン

  1. 01ビットコインの ZAR建て現在価格の確認
  2. 02Luno アカウントの残高と過去の取引履歴の確認
  3. 03AI クライアント内での相場データの参照

MCP 対応

MCP サーバーとして動作し、取引所の相場、アカウント、取引に関する機能をツールやリソースとして MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "luno": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "\\"
      ]
    }
  }
}
起動コマンドdocker run -i --rm '\'

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
oci\

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Luno MCP サーバー

Quality Gate Status Coverage Bugs Security Rating Vulnerabilities Duplicated Lines (%) Go Report Card GoDoc luno-mcp MCP server

Luno 暗号資産取引所 API へのアクセスを提供する Model Context Protocol（MCP）サーバーです。

このサーバーは Claude Code/VSCode/Cursor（およびその他の MCP 互換クライアント）との統合を可能にし、Luno 暗号資産取引所に関連するコンテキスト情報と機能を提供します。

はじめに

一部のツールでは、Luno API キーとシークレットが必要です。これらは Luno アカウント設定 から取得してください。

VS Code にインストール VS Code Insiders にインストール Cursor にインストール

標準設定 (Docker) はほとんどの MCP クライアントで動作します:

{
  "mcpServers": {
    "luno": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=YOUR_API_KEY_ID",
        "-e", "LUNO_API_SECRET=YOUR_API_SECRET",
        "ghcr.io/luno/luno-mcp:latest"
      ]
    }
  }
}
Claude Code

Docker を使用する場合:

claude mcp add luno -- docker run --rm -i -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET ghcr.io/luno/luno-mcp:latest

または、ソースからビルドした場合:

claude mcp add luno -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET -- luno-mcp
Claude Desktop

1 行でインストールと設定を行う方法 (macOS):

curl -fsSL https://raw.githubusercontent.com/luno/luno-mcp/main/claude-desktop-install.sh | \
  LUNO_API_KEY_ID=<key> LUNO_API_SECRET=<secret> sh

または、標準設定を claude_desktop_config.json に手動で追加します (セットアップガイド)。

Cursor

Cursor Settings → MCP → Add new MCP Server に移動します。command タイプを使用し、コマンドに docker、引数に上記の標準設定の args を指定します。

または、標準設定を .cursor/mcp.json に追加します。

Windsurf

Windsurf MCP のドキュメントに従ってください。上記の標準設定を使用します。

VS Code (手動設定)

上記のバッジをクリックすると Docker をワンクリックでインストールできます。または、以下の内容を VS Code の settings.json または .vscode/mcp.json に追加します:

Docker を使用する場合
{
  "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}
  ],
  "servers": {
    "luno": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=${input:luno_api_key_id}",
        "-e", "LUNO_API_SECRET=${input:luno_api_secret}",
        "ghcr.io/luno/luno-mcp:latest"
      ]
    }
  }
}
ソースから
{
  "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}
  ],
  "servers": {
    "luno": {
      "command": "luno-mcp",
      "env": {
        "LUNO_API_KEY_ID": "${input:luno_api_key_id}",
        "LUNO_API_SECRET": "${input:luno_api_secret}"
      }
    }
  }
}
SSE トランスポート
{
  "servers": {
    "luno": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}
ソースからのビルド

Go 1.25 以降が必要です。

直接インストール:

go install github.com/luno/luno-mcp/cmd/server@latest

またはクローンしてビルド:

git clone https://github.com/luno/luno-mcp
cd luno-mcp
go build -o luno-mcp ./cmd/server

必要に応じてシステム全体で利用可能にします:

sudo mv luno-mcp /usr/local/bin/
Homebrew (macOS)

Homebrew から luno/homebrew-luno-mcp タップを使用してインストールします:

brew tap luno/luno-mcp
brew install luno-mcp

次に、MCP クライアントを設定します:

{
  "mcpServers": {
    "luno": {
      "command": "luno-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "LUNO_API_KEY_ID": "YOUR_API_KEY_ID",
        "LUNO_API_SECRET": "YOUR_API_SECRET"
      }
    }
  }
}

または Claude Code で:

claude mcp add luno -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET -- luno-mcp
Docker

上記の標準設定を使用するか、直接実行します:

docker run --rm -i \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  ghcr.io/luno/luno-mcp:latest

SSE モードの場合:

docker run --rm \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  -p 8080:8080 \
  ghcr.io/luno/luno-mcp:latest \
  --transport sse --sse-address 0.0.0.0:8080

オプションの環境変数:

  • LUNO_API_DEBUG=true — デバッグログを有効にします
  • LUNO_API_DOMAIN=api.staging.luno.com — API ドメインを上書きします
  • ALLOW_WRITE_OPERATIONS=true — 書き込み操作を有効にします（create_order、cancel_order、convert）

標準設定（Docker）はほとんどの MCP クライアントで動作します:

{
  "mcpServers": {
    "luno": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=YOUR_API_KEY_ID",
        "-e", "LUNO_API_SECRET=YOUR_API_SECRET",
        "ghcr.io/luno/luno-mcp:latest"
      ]
    }
  }
}
Claude Code

Docker を使用する場合:

claude mcp add luno -- docker run --rm -i -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET ghcr.io/luno/luno-mcp:latest

またはソースからビルドした場合:

claude mcp add luno -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET -- luno-mcp
Claude Desktop

ワンラインでのインストールと設定（macOS）:

curl -fsSL https://raw.githubusercontent.com/luno/luno-mcp/main/claude-desktop-install.sh | \
  LUNO_API_KEY_ID=<key> LUNO_API_SECRET=<secret> sh

または、標準設定を claude_desktop_config.json に手動で追加します（セットアップガイド）。

Cursor

Cursor Settings → MCP → Add new MCP Server に移動します。command タイプを使用し、コマンドに docker、引数に上記の標準設定の args を指定します。

または、標準設定を .cursor/mcp.json に追加します。

Windsurf

Windsurf MCP のドキュメントに従ってください。上記の標準設定を使用します。

VS Code（手動設定）

上記のバッジをクリックして Docker をワンクリックインストールするか、VS Code の settings.json または .vscode/mcp.json に以下を追加します:

Docker を使用する場合
{
  "servers": {
    "luno": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=${input:luno_api_key_id}",
        "-e", "LUNO_API_SECRET=${input:luno_api_secret}",
        "ghcr.io/luno/luno-mcp:latest"
      ],
      "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}
      ]
    }
  }
}
ソースからの場合
{
  "servers": {
    "luno": {
      "command": "luno-mcp",
      "env": {
        "LUNO_API_KEY_ID": "${input:luno_api_key_id}",
        "LUNO_API_SECRET": "${input:luno_api_secret}"
      },
      "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}
      ]
    }
  }
}
SSE トランスポート
{
  "servers": {
    "luno": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}
ソースからのビルド

Go 1.25 以降が必要です。

直接インストール:

go install github.com/luno/luno-mcp/cmd/server@latest

またはクローンしてビルド:

git clone https://github.com/luno/luno-mcp
cd luno-mcp
go build -o luno-mcp ./cmd/server

必要に応じてシステム全体で利用可能にします:

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

上記の標準設定を使用するか、直接実行します:

docker run --rm -i \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  ghcr.io/luno/luno-mcp:latest

SSE モードの場合:

docker run --rm \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  -p 8080:8080 \
  ghcr.io/luno/luno-mcp:latest \
  --transport sse --sse-address 0.0.0.0:8080

オプションの環境変数:

  • LUNO_API_DEBUG=true — デバッグログを有効にします
  • LUNO_API_DOMAIN=api.staging.luno.com — API ドメインを上書きします
  • ALLOW_WRITE_OPERATIONS=true — 書き込み操作を有効にします（create_order、cancel_order、convert）

機能

  • リソース: 口座残高、取引履歴などへのアクセス
  • ツール: 注文の作成と管理、価格の確認、取引詳細の表示のための機能
  • セキュリティ: Luno API キーを使用した安全な認証
  • VS Code 統合: VSCode やその他の AI IDE との簡単な統合

利用可能なツール

ツールカテゴリ説明認証が必要書き込み
get_tickerマーケットデータ取引ペアの現在のティッカー情報を取得します❌❌
get_tickersマーケットデータ指定したペア（またはすべて）のティッカーを一覧表示します❌❌
get_order_bookマーケットデータ取引ペアのオーダーブックを取得します❌❌
list_tradesマーケットデータ通貨ペアの最近の取引を一覧表示します❌❌
get_candlesマーケットデータ通貨ペアのローソク足マーケットデータを取得します❌❌
get_markets_infoマーケットデータサポートされているすべてのマーケットのパラメータ情報を一覧表示します❌❌
get_balancesアカウント情報すべてのアカウントの残高を取得します✅❌
create_order取引新規の買い注文または売り注文を作成します✅✅
cancel_order取引既存の注文をキャンセルします✅✅
list_orders取引未約定の注文を一覧表示します✅❌
list_transactionsトランザクションアカウントのトランザクションを一覧表示します✅❌
get_transactionトランザクション特定のトランザクションの詳細を取得します✅❌
convert取引2 つの通貨間で即時に変換します✅✅

コマンドラインオプション

  • --transport: トランスポート種別（stdio、sse、または streamable-http。デフォルト: stdio）
  • --sse-address: SSE および Streamable HTTP トランスポート用のアドレス（デフォルト: localhost:8080）
  • --domain: Luno API ドメイン（デフォルト: api.luno.com）
  • --log-level: ログレベル（debug、info、warn、error。デフォルト: info）
  • --allow-write-operations: 書き込み操作（create_order、cancel_order、convert）を有効にします。環境変数 ALLOW_WRITE_OPERATIONS でも設定できます

例

ウォレットの操作

LLM にウォレットの残高を表示するよう依頼できます:

What are my current wallet balances on Luno?
取引

LLM に取引を支援するよう依頼できます:

Create a limit order to buy 0.001 BTC at 50000 ZAR
トランザクション履歴

LLM にトランザクション履歴を表示するよう依頼できます:

Show me my recent Bitcoin transactions
マーケットデータ

LLM にマーケットデータを表示するよう依頼できます:

Show me recent trades for XBTZAR

What's the latest price for Bitcoin in ZAR?

セキュリティに関する考慮事項

このツールは、あなたの Luno アカウントにアクセスできる API 認証情報を必要とします。API キー、特に出金権限を持つものを使用する際は注意してください。特定のユースケースに必要な権限のみを持つ API キーを作成することをお勧めします。

書き込み操作の制御

デフォルトでは、MCP サーバーは読み取り専用モードで動作します — create_order、cancel_order、convert は公開されません。これらを有効にするには、ALLOW_WRITE_OPERATIONS を true、1、または yes に設定します。このフラグを追加する場所については、上記の設定例を参照してください。

API 認証情報のベストプラクティス
  1. 権限を限定した API キーを作成する: ユースケースに絶対に必要な権限のみを付与してください
  2. 認証情報をバージョン管理にコミットしない: .env ファイルが常に .gitignore に含まれていることを確認してください
  3. API キーを定期的にローテーションする: 潜在的な漏洩の影響を抑えるため、API キーを定期的に再生成してください
  4. API の使用状況を監視する: 不正なアクティビティがないか、Luno アカウントを定期的に確認してください
  5. デフォルトで読み取り専用モードを使用する: 書き込み操作は本当に必要な場合にのみ有効にしてください

コントリビューション

このプロジェクトの開発に貢献したい場合は、ガイドラインについて CONTRIBUTING.md ファイルを参照してください。

ライセンス

MIT License

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。