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キー、シークレット

ソースからのビルド

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?

📚 ドキュメント

資格情報の設定

サーバーには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)

利用可能なツール

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が設定されています。

1. 単体テスト：mainブランチへのすべてのpushイベントとプルリクエストで自動的に実行されます。
2. 統合テスト：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キーを作成することをお勧めします。

💡 使用建议

1. 制限付き権限のAPIキーを作成する：ユースケースに必要な最小限の権限のみを付与します。
2. 資格情報をバージョン管理にコミットしない：.envファイルが常に.gitignoreに含まれていることを確認します。
3. APIキーを定期的にローテーションする：潜在的な漏洩の影響を制限するために、定期的にAPIキーを再生成します。
4. APIの使用状況を監視する：定期的にLunoアカウントで不正なアクティビティがないか確認します。