mcp-server-operator

MCP サーバーオペレーター

MCP サーバーオペレーターは、OpenShift クラスター上の MCP（Model Context Protocol）サーバーのライフサイクルを管理します。カスタムリソース定義（CRD）MCPServerを活用して、ユーザーはカスタム MCP サーバーのデプロイ時に、MCP サーバーのイメージと実行時引数を指定できます。

機能

• CRD を介して MCP サーバーインスタンスをデプロイ、管理します
• カスタムコンテナーイメージと実行時引数に対応しています
• Openshift クラスターと互換性があります
• エンドツーエンドテストと単体テストの両方が含まれています。

目次

• プロジェクトの概要
• 機能
• 使い方
  • 前提条件
  • インストール
  • オペレーターをローカルで実行する
  • クラスター上でオペレーターを実行する
  • MCP サーバーインスタンスの作成
  • オペレーターのアンインストールとクラスターのクリーンアップ
• 開発者ガイド
  • 前提条件
  • テストの実行
  • コントリビューション

使い方

前提条件

インストールする前に、オペレーターを実行するために以下が必要です。

• OpenShift クラスター（ROSA、OSD、CRC）、または互換性のある Kubernetes クラスター
• コンテナーエンジン（podmanまたはdocker）
• OpenShift CLI ツール：oc
• CRD のインストールとオペレーターのデプロイに必要な権限

インストール

以下の手順を始める前に、クラスターを使用する場合はクラスターにログインしていることを確認してください。

oc login --token=<your user token> --server=<your openshift cluster server>

クラスターにログインしたら、リポジトリーをクローンしてから、mcp-server-operator フォルダーに移動します。

git clone https://github.com/opendatahub-io/mcp-server-operator.git

cd mcp-server-operator

次に、環境変数を設定します。

export IMG=<your-registry>/<username>/mcp-server-operator:<tag>

その後、イメージをビルドします。

CONTAINER_TOOL={docker|podman} IMG=$IMG make build

続いて、必要な CRD をインストールします。

make install

オペレーターをローカルで実行する

make run

クラスター上でオペレーターを実行する

make deploy IMG=$IMG

MCP サーバーインスタンスの作成

以下は MCPServer の作成例です。コマンドを実行する前に、角括弧内のテキストを適切な情報に置き換えてください。

cat << EOF | oc create -f -
apiVersion: mcpserver.opendatahub.io/v1
kind: MCPServer
metadata:
  name: <your_name_here>
  namespace: mcp-server-operator-system
spec:
  image: <your_image_here>
  args:
    - <arg 1>
    - <arg 2>
  command:
    - <command 1>
    - <command 2>
EOF

フィールドの説明

• image：MCP サーバーのコンテナーイメージです。
• args：（任意）MCP サーバーコンテナーに渡す実行時引数のリストです。
• command：（任意）MCP サーバーコンテナーに渡すエントリーポイントコマンドのリストです。

オペレーターのアンインストールとクラスターのクリーンアップ

まず、次のコマンドを使用してクラスターから MCPServer オブジェクトを削除します。

oc delete mcpserver -n mcp-server-operator-system [name]

次に、以下のコマンドを実行するだけでオペレーターをアンインストールできます。

make undeploy

開発者ガイド

前提条件

• Go 1.23
• Kubebuilder

テストの実行

単体テストを実行するには、次のコマンドを実行します。

make test

エンドツーエンドテストを実行するには、次のコマンドを実行します。

make test-e2e

コントリビューション

コントリビューションを歓迎します！コントリビューションガイドラインをご覧ください。