Luno-mcp：Luno暗号通貨取引所APIを統合、MCP互換クライアント開発に最適

Luno MCP

Luno MCPサーバーは、Model Context Protocolに基づくサーバーで、Luno暗号通貨取引所APIとの統合を提供し、VS Code CopilotなどのMCP互換クライアントがアカウント情報、取引機能、市場データにアクセスできるようにします。

金融開発者ツール #暗号通貨 #API統合 #取引ツール #VS Codeプラグイン .Go

スコア : 2.5ポイント

ダウンロード数 : 4.9K

更新時間 : 2025-07-24

サイトを開く

Luno MCPサーバーとは？

Luno MCPサーバーは、Model Context Protocol (MCP)サービスで、VS Code Copilotなどのツールを通じてユーザーがLuno暗号通貨取引所の機能にアクセスできるようにします。アカウント残高、取引履歴、注文管理などの機能を提供します。

Luno MCPサーバーの使い方は？

Luno APIキーとシークレットが必要です。その後、コマンドラインまたはDockerを使用してサーバーを設定します。このサーバーはVS Codeと統合でき、エディタ内で直接取引情報を照会したり操作を実行したりできます。

適用シナリオ

Lunoの取引データを迅速にアクセスする必要がある開発者、トレーダー、自動化スクリプトに適しています。リアルタイムの市場データ取得、取引実行、アカウント管理に最適です。

主要機能

アカウント情報の確認

アカウント残高と取引履歴を確認できます。

市場データの取得

現在の取引ペアの相場情報、注文板、最近の取引記録の取得をサポートします。

注文管理

注文の作成、取消、確認ができ、取引操作を容易に行えます。

安全認証

Luno APIキーを使用して安全な認証を行い、アカウント情報を保護します。

VS Code統合

VS Code内で直接Copilot機能を使用でき、開発効率を向上させます。

利点

Luno APIへの簡便なアクセス方法を提供します。

VS Codeなどの開発環境に容易に統合できます。

複数の取引操作と市場データの取得をサポートします。

APIキーを使用した認証により、高いセキュリティ性を備えています。

制限

一部のLuno API機能は未実装です。

パフォーマンス問題や安定性問題が発生する可能性があります。

Luno APIキーが必要です。

現在はテスト段階であり、未発見のエラーが存在する可能性があります。

使い方

APIキーの取得

Lunoアカウントにログインし、開発者設定でAPIキーとシークレットを取得します。

サーバーの設定

コマンドライン引数またはDockerコンテナを使用してLuno MCPサーバーを設定します。

VS Codeへの接続

VS CodeにLuno MCPサーバーの設定を追加し、直接Copilot機能を使用できるようにします。

使用例

ウォレット残高の確認

ユーザーはCopilotに問い合わせることで、現在のウォレット残高を取得できます。

取引注文の作成

ユーザーはプロンプトを使用して、Copilotに取引注文の作成を依頼できます。

取引履歴の確認

ユーザーはCopilotに問い合わせることで、最近の取引記録を取得できます。

市場データの取得

ユーザーは最新の市場データ（取引ペアの価格など）を要求できます。

よくある質問

Luno MCPサーバーにはどのような設定が必要ですか？

Luno MCPサーバーをVS Codeに統合する方法は？

Luno MCPサーバーは安全ですか？

Luno MCPサーバーにはどのような制限がありますか？

🚀 Luno MCP Server

このサーバーは、Model Context Protocol (MCP) サーバーであり、Luno仮想通貨取引所APIへのアクセスを提供します。VS CodeのCopilotや他のMCP互換クライアントとの統合を可能にし、Luno仮想通貨取引所に関連するコンテキスト情報と機能を提供します。

🚀 クイックスタート

このサーバーを使用することで、VS CodeのCopilotや他のMCP互換クライアントとの統合が可能になり、Luno仮想通貨取引所に関連するコンテキスト情報と機能を利用できます。

⚠️ ベータ版注意事項

このプロジェクトは現在ベータ段階です。安定性と信頼性を確保するために尽力していますが、予期しない動作や制限に遭遇する可能性があります。以下の点に注意して使用してください。

このMCPサーバーの設定は事前通知なしに変更される可能性があります。
パフォーマンスと信頼性が最適でない場合があります。
すべてのLuno APIエンドポイントが実装されているわけではありません。

プロジェクトの改善にご協力いただけるよう、フィードバックやバグ報告を歓迎します。遭遇した問題はGitHubのissueトラッカーを通じて報告してください。

✨ 主な機能

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

📦 インストール

前提条件

Go 1.24以降
LunoアカウントとAPIキー、シークレット

ソースからのビルド

リポジトリをクローンします。

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/
```

💻 使用例

ウォレットの操作

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?

📚 ドキュメント

資格情報の設定

サーバーにはLuno APIキーとシークレットが必要です。これらはLunoアカウントの設定から取得できます。詳細はこちらを参照してください：https://www.luno.com/developers。

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

--transport：トランスポートタイプ (stdio または sse、デフォルト: stdio)
--sse-address：SSEトランスポートのアドレス (デフォルト: localhost:8080)
--domain：Luno APIドメイン (デフォルト: api.luno.com)
--log-level：ログレベル (debug, info, warn, error、デフォルト: info)

利用可能なツール

ツール	カテゴリ	説明
`get_ticker`	市場データ	取引ペアの現在のティッカー情報を取得
`get_order_book`	市場データ	取引ペアのオーダーブックを取得
`list_trades`	市場データ	通貨ペアの最近の取引をリストする
`get_balances`	アカウント情報	すべての口座の残高を取得
`create_order`	取引	新しい買いまたは売り注文を作成
`cancel_order`	取引	既存の注文をキャンセル
`list_orders`	取引	未決済の注文をリストする
`list_transactions`	取引履歴	口座の取引をリストする
`get_transaction`	取引履歴	特定の取引の詳細を取得

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"
    }
  }
}

🔧 技術詳細

テスト

このプロジェクトには単体テストと統合テストの両方が含まれています。単体テストは資格情報なしで実行できますが、統合テストにはLuno API資格情報が必要です。

# 単体テストのみを実行
go test -v ./... -short

# 統合テストを実行（API資格情報が必要）
go test -v ./internal/tests -run "Integration" -skip=""

GitHub Actions

このリポジトリは、継続的インテグレーションテストのためにGitHub Actionsが設定されています。

単体テスト：mainブランチへのすべてのpushイベントとプルリクエストで自動的に実行されます。
統合テスト：GitHub Actionsタブの「Manual Integration Tests」ワークフローを使用して手動で実行できます。

GitHub Actionsで統合テストを実行するには、リポジトリに以下のシークレットを設定する必要があります。

LUNO_API_KEY：あなたのLuno APIキー
LUNO_API_SECRET：あなたのLuno APIシークレット
RUN_INTEGRATION_TESTS：mainブランチで統合テストを有効にするには、空でない値に設定します。

統合テストは、明示的にトリガーされた場合または設定されたmainブランチでのみ実行されるように設定されています。

コントリビュート

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

📄 ライセンス

MIT License

⚠️ 重要提示

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

💡 使用建议

制限付き権限のAPIキーを作成する：ユースケースに必要な最小限の権限のみを付与します。

資格情報をバージョン管理にコミットしない：.envファイルが常に.gitignoreに含まれていることを確認します。

APIキーを定期的にローテーションする：潜在的な漏洩の影響を制限するために、定期的にAPIキーを再生成します。

APIの使用状況を監視する：定期的にLunoアカウントで不正なアクティビティがないか確認します。