Ocireg MCP

🚀 OCI Registry MCP Server

OCIレジストリとイメージ参照のクエリツールを提供するMCP（Model Context Protocol）サーバーです。このサーバーは、LLMを搭載したアプリケーションがOCIレジストリとやり取りできるようにし、コンテナイメージの情報取得やタグの一覧表示などの機能を提供します。

🚀 クイックスタート

このOCI Registry MCPサーバーは、OCIレジストリとイメージ参照に関する情報を取得するためのMCPサーバーです。以下の手順でサーバーを起動し、OCIレジストリとのやり取りを開始できます。

✨ 主な機能

• OCIイメージに関する情報を取得する
• リポジトリのタグを一覧表示する
• イメージマニフェストを取得する
• イメージコンフィグを取得する

📦 インストール

ToolHiveを使用した実行（推奨）

OCI Registry MCPサーバーを実行する最も簡単な方法は、ToolHiveを使用することです。ToolHiveは、MCPサーバーの安全なコンテナ化されたデプロイを提供します。

# ToolHiveをインストールする（まだインストールされていない場合）
# 詳細は: https://github.com/stacklok/toolhive#installation を参照
# サポートされているクライアントを自動的に構成するための自動検出を有効にする
thv config auto-discovery true

# ToolHiveで 'oci-registry' としてパッケージ化されたOCI Registry MCPサーバーを実行する
thv run oci-registry

# 実行中のサーバーを一覧表示する
thv list

# サーバーの詳細情報を取得する
thv registry info oci-registry

これで、MCP互換クライアントからサーバーにアクセスし、OCIレジストリのイメージ情報をクエリできます。

ToolHiveでの認証

プライベートレジストリにアクセスする必要がある場合は、ToolHiveのシークレット管理を使用して認証資格情報を提供できます。

# ベアラートークン認証の場合
thv secret set oci-token
# ベアラートークンを入力するように求められたら入力する

thv run --secret oci-token,target=OCI_TOKEN oci-registry

# ユーザー名/パスワード認証の場合
thv secret set oci-username
thv secret set oci-password
# 資格情報を入力するように求められたら入力する

thv run --secret oci-username,target=OCI_USERNAME --secret oci-password,target=OCI_PASSWORD oci-registry

💻 使用例

基本的な使用法

このサーバーは、OCIレジストリとのやり取りを行うためのMCPツールを提供します。以下は、各ツールの使用例です。

get_image_info

OCIイメージに関する情報を取得します。

入力:

• image_ref: イメージ参照 (例: docker.io/library/alpine:latest)

出力:

• ダイジェスト、サイズ、アーキテクチャ、OS、作成日、レイヤー数を含むイメージ情報

list_tags

リポジトリのタグを一覧表示します。

入力:

• repository: リポジトリ名 (例: docker.io/library/alpine)

出力:

• リポジトリのタグのリスト

get_image_manifest

OCIイメージのマニフェストを取得します。

入力:

• image_ref: イメージ参照 (例: docker.io/library/alpine:latest)

出力:

• イメージマニフェスト

get_image_config

OCIイメージのコンフィグを取得します。

入力:

• image_ref: イメージ参照 (例: docker.io/library/alpine:latest)

出力:

• イメージコンフィグ

📚 ドキュメント

開発

前提条件

• Go 1.21 以上
• OCIレジストリへのアクセス

認証

このサーバーは、プライベートOCIレジストリにアクセスするための以下の認証方法をサポートしています。

1. ベアラートークン: 以下の環境変数を設定します。

   • OCI_TOKEN: レジストリ認証用のベアラートークン

2. ユーザー名とパスワード: 以下の環境変数を設定します。

   • OCI_USERNAME: レジストリ認証用のユーザー名
   • OCI_PASSWORD: レジストリ認証用のパスワード

3. Dockerコンフィグ: トークンまたはユーザー名/パスワードが提供されない場合、サーバーはデフォルトのDockerキーチェーンを使用します。これは、~/.docker/config.json から資格情報を読み取ります。

例:

# ベアラートークン認証
export OCI_TOKEN=mytoken

# ユーザー名/パスワード認証
export OCI_USERNAME=myuser
export OCI_PASSWORD=mypassword

ポート構成

サーバーは、以下のいずれかを使用して特定のポートでリッスンするように構成できます。

1. 環境変数:

   • MCP_PORT: リッスンするポート番号 (0 から 65535 の間でなければなりません)
   • 設定されていないか無効な場合、デフォルトでポート 8080 を使用します

2. コマンドラインフラグ:

   • -port: 環境変数の設定を上書きします (0 から 65535 の間でなければなりません)
   • 無効なポートが指定された場合、デフォルトでポート 8080 を使用します
   • 例: ./ocireg-mcp -port 9090

テスト

go test ./...

リント

golangci-lint run

コントリビューション

このMCPサーバーへのコントリビューションを歓迎します！コントリビュートしたい場合は、CONTRIBUTINGガイドを確認して、始める方法の詳細を確認してください。

バグに遭遇した場合や機能リクエストがある場合は、リポジトリで問題を開いてください。また、コミュニティDiscordサーバーの #mcp-servers チャンネルに参加することもできます。

📄 ライセンス

このプロジェクトは、Apache v2ライセンスの下でライセンスされています。詳細は、LICENSEファイルを参照してください。