Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

MCP Mirror Endpoint + RHOAI Version Normalization (issue 7 of 29)

オープン
  • 何か問題がありますか？
#4,045 コメント 11 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
42/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript
領域
api, backend, documentation, observability, security

調査の方向性

openspec/changes/mcp-registry-connector/specs/mirror-endpoint/spec.md と openspec/changes/rhoai-connector/specs/mcp-catalog-source/spec.md から始め、次にタスクリストを使って config.d.ts と connector のエントリポイントを見つけます。mirror の設定、検証、警告、メトリクス、テスト、ドキュメントが完了し、出力される RHOAI エンティティに、指定されたフォールバックのログ出力を伴う正規化済みのバージョンアノテーションが含まれていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

feature triaged workspace/boost

Labels: ready-to-code
Dependencies: None
RHIDP Stories: RHIDP-15317, RHIDP-15321
Feature: RHDHPLAN-1510 — Epics RHIDP-15313, RHIDP-15314

Implement the MCP Registry mirror endpoint configuration with zero-internet validation (no outbound traffic to public endpoint when mirror is configured), startup health check, and non-HTTPS security warnings. Also implement RHOAI version normalization utility for MCP server entity rhdh.io/ai-asset-version annotation population. RHIDP-15321 has no cross-connector dependencies and can start immediately.

Tasks

From openspec/changes/mcp-registry-connector/tasks.md group 1 (RHIDP-15317):

  • 1.1 Add ai-catalog.providers.mcpRegistry.endpoint config schema in config.d.ts
  • 1.2 Implement endpoint configuration loading from app-config
  • 1.3 Add environment variable override support (MCP_REGISTRY_ENDPOINT)
  • 1.4 Implement endpoint URL validation
  • 1.5 Add endpoint fallback logic (app-config > env var > default public endpoint)
  • 1.6 Implement startup endpoint validation health check
  • 1.7 Add endpoint configuration logging at connector startup
  • 1.8 Add security warning for non-HTTPS endpoints
  • 1.9 Implement HTTP client configuration with mirror endpoint URL
  • 1.10 Add Prometheus metrics for endpoint request count, latency, error rate
  • 1.11 Add Prometheus metric for public endpoint violation detection
  • 1.12–1.18 Integration tests: zero outbound traffic, mirror targeting, DNS resolution, retry backoff, invalid URL, non-HTTPS warning, override precedence
  • 1.19–1.20 Documentation: mirror endpoint examples, zero-internet validation

From openspec/changes/rhoai-connector/tasks.md group 7 (RHIDP-15321):

  • 7.1 Define version normalization rules
  • 7.2 Implement normalizeVersion(rawVersion) utility — semver normalization, strip v prefix, handle latest/nightly
  • 7.3 Populate rhdh.io/ai-asset-version annotation with normalized version
  • 7.4 Handle missing version metadata: set "unknown" with DEBUG log
  • 7.5 Handle invalid version strings: set "unknown" with WARNING log
  • 7.6 Unit tests for version normalization
  • 7.7 Integration test: emitted entities carry correct annotation
Specifications
  • openspec/changes/mcp-registry-connector/specs/mirror-endpoint/spec.md
  • openspec/changes/rhoai-connector/specs/mcp-catalog-source/spec.md
主要言語
TypeScript
スター
51
フォーク
121
平均マージ
1日 14時間
マージ済み PR（30日）
286

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

redhat-developer/rhdh-plugins のほかの issue

redhat-developer/rhdh-plugins の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。