MCP Opsbeacon Server

MCP Opsbeacon Server

Opsbeacon の操作を行うための MCP（Model Context Protocol）サーバー実装です。このサーバーを使用すると、Claude を通じて Opsbeacon API とやり取りでき、コマンドや接続を一覧表示するツールを利用できます。

機能

• 利用可能な Opsbeacon コマンドを一覧表示
• 利用可能な Opsbeacon 接続を一覧表示
• ベアラートークンによる認証
• エラー処理とログ記録
• 構造化された JSON レスポンスを返します

前提条件

• Python 3.10 以降
• Opsbeacon API へのアクセス
• 有効なベアラートークン

インストール

1. リポジトリをクローンします：

git clone [repository-url]
cd mcp-opsbeacon-server

2. パッケージをインストールします：

pip install -e .

設定

Opsbeacon の設定を指定する方法は 3 つあります。

オプション 1：Claude Desktop で使用する

MCP サーバーを Claude で使用する場合は、必要な設定を Claude Desktop の設定ファイルに追加します。

{
  "mcpServers": {
    "opsbeacon": {
      "command": "python",
      "args": [
        "-m",
        "mcp_opsbeacon_server"
      ],
      "env": {
        "OPSBEACON_TOKEN": "your-bearer-token-here",
        "OPSBEACON_BASE_URL": "your-base-url-here"
      }
    }
  }
}

オプション 2：環境変数を使用する

必要な環境変数を直接設定できます。

export OPSBEACON_TOKEN="your-bearer-token-here"
export OPSBEACON_BASE_URL="your-base-url-here"

オプション 3：.env ファイルを使用する（開発時に推奨）

プロジェクトのルートディレクトリに .env ファイルを作成します。用意されているテンプレートを使用できます。

cp .env.example .env

次に、実際の値を .env ファイルに設定します。

OPSBEACON_TOKEN=your-bearer-token-here
OPSBEACON_BASE_URL=your-base-url-here  # Optional, defaults to https://api.console.opsbeacon.com

機密情報がコミットされないよう、.env ファイルは git の対象外になっています。

ベース URL の設定

OPSBEACON_BASE_URL の設定は任意です。指定しない場合、サーバーはデフォルト URL を使用します。

https://api.console.opsbeacon.com

上記のいずれかの設定方法で OPSBEACON_BASE_URL を設定すると、このデフォルト値を上書きできます。

設定の優先順位

これらのオプションは同時に使用できます。複数のオプションを使用する場合、優先順位は次のとおりです。

1. 環境変数
2. .env ファイル
3. Claude の設定
4. デフォルトのベース URL

テスト

サーバーの機能をテストするには、上記のいずれかの方法で必要な変数を設定したことを確認してから（開発時は .env ファイルの使用を推奨）、次を実行します。

python test_server.py

使用方法

利用可能なツール

1. list_commands

   • 利用可能なすべての Opsbeacon コマンドを一覧表示します
   • 追加のパラメーターは不要です
   • コマンドの詳細を JSON 形式で返します

2. list_connections

   • 利用可能なすべての Opsbeacon 接続を一覧表示します
   • 追加のパラメーターは不要です
   • 接続の詳細を JSON 形式で返します

Claude での使用例

Human: List all available Opsbeacon commands.
Claude: Let me help you list the available commands using the Opsbeacon MCP server.

エラー処理

よくあるエラーケース：

1. OPSBEACON_TOKEN environment variable is not set：トークンが claude_desktop_config.json に正しく設定されていることを確認してください
2. Error listing commands/connections：ネットワーク接続とトークンの有効性を確認してください
3. Connection refused：Opsbeacon API にアクセスできることを確認してください

開発

機能の追加や既存機能の変更を行うには：

1. 変更を加えます
2. テストスクリプトを実行して、機能を確認します
3. 必要に応じてドキュメントを更新します