Kujolang.ai MCP

Kujolang.ai MCP サーバー

バージョン 0.2.0 は、この読み取り専用カタログサーバーの、セキュリティ強化済みプレビュー版です。ソースリリースとホストされたカタログはそれぞれ独立したリビジョンを持つため、現在のカタログについては /health と生成された来歴レシートを確認してください。既存の運用上および相互運用性に関する制限は、リンク先のレビュー文書に記載されています。

kujolang-mcp は、Kujo のプロジェクト、プリミティブ、ツール群、ショーケース、エージェントスキル、ワークフロー、およびレビュー済みのインストール手順を検索するための、読み取り専用 Model Context Protocol サーバーです。ネイティブランタイムとカタログジェネレーターは Kujo で記述されています。生成される Cloudflare アダプターには、ホスティングと集計テレメトリーのための JavaScript が含まれています。

このリポジトリは Kujolang.ai のカタログサーバーであり、再利用可能な kujolang/mcp フレームワークではありません。このフレームワークの慣例に従いながら、独立してデプロイできる、製品固有のサーバーとして構成されています。

準備状況

このリポジトリには、ネイティブのリファレンスサーバーと、生成された Cloudflare Worker ターゲットが含まれています。公開 MCP カタログインターフェースは、範囲が限定され、ステートレスで、決定論的かつ読み取り専用です。ホストされたアダプターは、それとは別に、日次の集計分析カウンターを管理します。Worker は Kujo の定義とレビュー済みカタログから生成され、Cloudflare が実行するのは生成済み JavaScript アーティファクトであり、Kujo ソースを直接実行するわけではありません。これは正式なエンタープライズ認証を取得したという主張ではありません。

デプロイ検証が完了すると、公開 URL は https://mcp.kujolang.ai/mcp、ヘルスチェックの URL は https://mcp.kujolang.ai/health になります。ローカルでの利用は常に可能です。

エージェントでできること

• Kujo と現在の公開カタログについて理解できます。
• プロジェクト、プリミティブ、ツール群、ショーケース、スキル、ワークフローを一覧表示および検索できます。
• ソースリンク、インストールテキスト、バージョン、適用範囲に関する注記を含む正確なレコードを取得できます。
• 具体的な作業に向けた、小規模で決定論的なスタックの推奨を受け取れます。
• デフォルト、グループ別、完全なインストーラープロファイルを、実行せずに確認できます。
• 無関係な検索結果で結果上限が消費されないようにしながら、WebOps の機能を見つけられます。

7 つのツールはすべて読み取り専用で、決定論的かつ冪等です。書き込みツール、任意の URL の取得機能、ファイルシステムパスの入力、シェル入力、パッケージインストーラー、デプロイ操作、シークレットの読み取り機能はありません。

クイックスタート

ローカルで実行する

run、test、HTTP 標準ライブラリを備えた Kujo ランタイムを使用します。

cd /path/to/kujolang-mcp
kujo run server.kujo -- --self-check
kujo run server.kujo

ローカルエンドポイントは http://127.0.0.1:8941/mcp です。/mcp/v1 は互換性のためのエイリアスで、/health はヘルスチェック用のエンドポイントです。

ローカルの Streamable HTTP クライアントを使用する場合：

{
  "mcpServers": {
    "kujolang": {
      "type": "http",
      "url": "http://127.0.0.1:8941/mcp"
    }
  }
}

このサーバーは MCP 2026-07-28 と、ハンドシェイク時代の 2025-06-18 を通知します。本番構成では、2026 リクエストに対して厳密な Mcp-Method と Mcp-Name のバインディングが有効になります。

GitHub MCP Registry からすばやくインストールする

Kujolang.ai MCP はGitHub MCP Registry に掲載されています。ホスト型サービスにすばやく接続するには、掲載ページを開いて Install MCP server を選択し、対応しているクライアント向けの手順に従ってください。

手動で設定する場合は、クライアントにリモート MCP サーバーを次のように追加します。

• Name: kujolang
• Transport: Streamable HTTP
• URL: https://mcp.kujolang.ai/mcp

ホストされたカタログでは、クライアント認証情報もローカルへのパッケージインストールも必要ありません。ご自身のマシンでサーバーを実行するには、上記のローカル手順を使用してください。

MCP レジストリへの公開

server.json には、公式 MCP レジストリのホスト型サービスが io.github.kujolang/kujolang-mcp として記述されています。これは、mcp-server.json のネイティブランタイム設定および mcp.manifest.json の Kujo マニフェストとは別のものです。

レジストリエントリは、このソースメタデータとは独立しています。レビュー済みの各リリースを検証して公開すると、レジストリが更新されます。このファイルをコミットしても公開されません。メタデータは https://mcp.kujolang.ai/mcp を参照しています。

このディレクトリから公式パブリッシャーをインストールし、メタデータを検証します。

brew install mcp-publisher
mcp-publisher validate

公開するには、kujolang 組織を所有する GitHub アカウントで認証してから、レビュー済みのメタデータを公開します。

mcp-publisher login github
mcp-publisher publish

ホスト型 MCP カタログには、クライアント認証情報やローカルへのパッケージインストールは不要です。以降のリリースでは、メタデータのバージョンをサーバーのリリースに合わせて更新し、公開前に検証してください。パブリッシャーの認証情報を Git に含めないでください。このレジストリへの公開は、github.com/mcp への掲載を保証するものではありません。GitHub への掲載リクエストは別の手順です。

MCP の機能

ツール	目的
get_kujo_overview	Kujo、カタログの件数、発見の流れ、信頼境界について説明します
list_ecosystem	種類やカテゴリでプロジェクト、スキル、ワークフローを絞り込みます
search_kujo_catalog	公開済みのカタログメタデータを検索します
get_catalog_item	指定した項目と、そのソースに基づくガイダンスを取得します
recommend_kujo_stack	タスクに合った、簡潔で決定論的な候補セットを返します
get_installation	デフォルト、コア、AI、品質、ショーケース、運用、または完全なインストール方法のガイダンスを返します
list_webops_capabilities	WebOps 機能コレクションのみを検索します

6 つのリソースが、概要、プロジェクト、スキル、ワークフロー、インストール、安全性に関するデータを提供します。3 つのプロンプトが、スタックの選定、導入計画、WebOps の発見を支援します。

リポジトリ構成

server.kujo                         Thin stable launcher
src/runtime.kujo                    Configuration, modes, and HTTP routing
src/http_security.kujo              Transport guards and security headers
src/protocol.kujo                   JSON-RPC and MCP dispatch
src/registry.kujo                   Tools, resources, and prompts
src/catalog.kujo                    Catalog validation, indexing, and search
data/catalog.json                   Reviewed deterministic catalog snapshot
scripts/sync_catalog.kujo           Kujo-only catalog synchronization
scripts/generate_worker.kujo        Kujo-only Worker generation
dist/worker.js                      Reviewed generated Cloudflare Worker
wrangler.jsonc                      Free-tier Worker deployment configuration
benchmarks/search_benchmark.kujo    Kujo-only search benchmark
tests/                              Kujo test suites and snapshots

ルートレベルのマニフェスト、ポリシー、設定、ライセンス、ドキュメント、および薄いランチャーは、パッケージマネージャー、運用担当者、リポジトリホストがそこで検出するため、ルートに置かれています。アプリケーションの実装は src/ 配下にあります。

カタログの整合性と同期

同梱のカタログは、起動時にスキーマ、項目の形式、スラッグの一意性、件数、SHA-256 コンテンツダイジェストについて検証されます。本番環境のリクエストで、隣接するウェブサイトのチェックアウトを読み込んだり、リモート URL を取得したりすることはありません。

レビュー済みの Kujolang.ai チェックアウトから再生成または検証します。

kujo run scripts/sync_catalog.kujo -- --site /path/to/kujolang.ai
kujo run scripts/sync_catalog.kujo -- --site /path/to/kujolang.ai --check

同期ツールは、重複または不正なスラッグや、想定外のソース URL スキームを拒否します。インストーラープロファイルの項目は、手作業で重複して管理するのではなく、ウェブサイトの公開インストーラーから解析されます。カタログのリビジョンはレコードとインストールプロファイルの両方を対象とします。意図しないスナップショットの破損を検出しますが、署名付きリリースや人によるレビューの代わりにはなりません。

現在のスナップショットには、プロジェクト 57 件、スキル 135 件、ワークフローレコード 45 件（合計 237 件、キット 44 件と Publishing House Operator）が含まれています。ソースには、単独で権威あるエージェントカタログはありません。エージェント関連のプロジェクト、SDK、スキル、ワークフローは、作り出したエージェントレコードとして提示するのではなく、実際のソース上の種類で引き続き発見できます。

ソースの正確性をレビューし、GitHub を更新し、設定済みのホスティングワークフローを通じてデプロイし、公開中のカタログを検証する自律型の週次エージェントプロンプトについては、docs/WEEKLY_REFRESH.md を参照してください。

セキュリティとパフォーマンスの制御

• 検索フィールドには長さの上限があり、正規化された検索語はカタログ処理の前に重複が排除され、件数が制限されます。
• 検索テキストと識別情報フィールドは、カタログの読み込み時に一度だけインデックス化されます。
• Host は必須で、許可リストに登録されている必要があります。Browser Origin が指定されている場合は、完全一致で許可リストに照合されます。
• JSON リクエストには、application/json、上限を設定したボディ構成、検証済みエンベロープ、オブジェクト形式のパラメーター、および決定論的なエラーが必要です。
• レスポンスには、no-store、no-sniff、frame、referrer、resource、および content の各セキュリティヘッダーが防御的に設定されます。
• ローカルのレート制限では、上限付きのピア IP バケットと、カウンターの競合を避けるためのハンドラーの直列受付を使用します。ヘルスチェックはクォータを消費しませんが、過負荷時の受付制御は共有します。
• 信頼できるイングレス制限を明示的に確認しない限り、ループバック以外での起動は失敗します。また、パブリックリスナーではアプリケーションローカルのリミッターが拒否されます。パブリッククォータと全体的な過負荷はイングレスで制御する必要があるためです。

Kujo 1.9.0 は、トランスポートのバッファリングを 8 MiB に制限します。カタログはその後、さらに小さい 128 KiB の UTF-8 バイト制限を適用します。パブリックなネイティブイングレスでは、転送前により小さい方の上限を適用する必要があります。Worker は解析前にストリームのバイト数を制限します。現在の制限、互換性の変更、未検証のデプロイ要件については、本番環境の強化を参照してください。

検証

kujo run scripts/sync_catalog.kujo -- --site /path/to/kujolang.ai --check
kujo run server.kujo -- --self-check
kujo run tests/run_all.kujo
kujo run benchmarks/search_benchmark.kujo
kujo run scripts/generate_worker.kujo -- --framework /path/to/mcp
node --check dist/worker.js

本番環境のデプロイ契約

本番環境の構成を明示的に選択してください。

KUJOLANG_MCP_CONFIG=mcp-server.production.example.json \
  kujo run server.kujo

信頼できるイングレスは、以下を行う必要があります。

• TLS を終端し、Kujo リスナーへのアクセスを許可するネットワークピアをイングレスのみにする。
• プロキシ転送前に、ボディのバイト数、接続／読み取りタイムアウト、クライアントごとのスロットリング、および全体的な過負荷の上限を適用する。
• 偽装可能なクライアント識別ヘッダーを上書きするか、破棄する。
• 正確なパブリック Host を使用して、/mcp と /health のみを転送する。
• アクセス／エラーメトリクス、アラート、容量制限、およびインシデント対応の振り分けを提供する。

パブリックカタログでは、ユーザー認証情報は意図的に不要です。プライベートデータやテナントデータ、リモート取得、書き込み、または実行機能を導入する場合は、この権限モデルを再設計し、認証を必須にする必要があります。

完全な境界についてはSECURITY.mdを、次回の本番対応作業リストについてはdocs/NEXT_SESSION_REVIEW.mdを参照してください。

ライセンス

MIT

リリースの最新状況

カタログの version と latest_release_url は、公開済みのコンポーネントリリースがある場合、そのリリースを示します。scope_note は、それ以降のデフォルトブランチでの作業、プレビューサポート、運用者に必要な対応を区別します。カタログの source_version は ウェブサイトのバージョンであり、Kujo ランタイムのバージョンではありません。kujo 項目に現在のランタイムを記録しています。非公開プロジェクトでは、公開用のソース情報とインストール情報のフィールドは空のままです。

9月9日のレビューでは、公開されている組織リポジトリ86件、リリース済みスキルのレコード135件、0.6.0 ディストリビューションに含まれるワークフロー44件すべてを確認しています。ソースの一覧は evidence/ecosystem-refresh-2026-09-09/ にあります。

ネイティブのカタログ生成とアサーションテストには Kujo 1.9.0 を使用してください。Node は生成された JavaScript Worker とネイティブ実装との同等性を検証するために使用します。ホスト型の読み取り専用カタログのランタイム依存関係ではありません。どちらのサーバーも、カタログのコンテンツに含まれるコマンドをインストールしたり実行したりすることはありません。

デプロイ後、node tests/production_catalog_test.mjs を実行して、すべての公開カタログレコードとインストーラープロファイルを、レビュー済みの生成済み Worker と比較してください。JSON レシートを保存するには RECEIPT_PATH を設定します。読み取り専用の MCP クエリを送信しますが、インストールコマンドは実行しません。

Kujo ランタイムの項目は、ランタイムの npm パッケージを含め、Linux x64/arm64、macOS x64/arm64、Windows x64 向けに公開された 1.9.0 リリースを示します。Wave C beta と Wave D alpha は引き続き実験的です。参加者向け SDK パッケージは引き続き非公開／未公開です。カタログは読み取り専用であり、リプレイ権限は付与しません。

9月29日の関連アップデートでは、Workcell、Ability、MCP 1.2.0 を記録しています。保存、制御下でのアプリケーション／STDIO 実行、Git との相関付けは、文書に記載された実験的な範囲を維持しています。ディスパッチの公開は別途行われます。

9月29日の SSG アップデートでは、SSG 1.1.0、デフォルトで有効な実験的パブリック WebMCP、独立したバージョン管理が行われるローカル Ability パック 1.0.0 を記録しています。また、レビュー済みの Kennel インストールガイダンスをウェブサイトと同期しています。カタログは読み取り専用のままであり、SSG ビルドやサイトのデプロイは実行しません。

10月7日の Tribunal アップデートでは、Tribunal 1.0.2、ローカル／運用者管理下での強化、タグに対応した正確なインストールコマンドを記録しています。デプロイ認定の範囲と、カタログの読み取り専用動作を維持しています。

10月8日に追加された Agent City では、Agent City 0.2.0、スタンドアロンインストーラー、ローカルでの動作範囲、ソースリンクを記録しています。レコードを取得するには、slug: "agent-city" を指定して get_catalog_item を使用してください。カタログはミッションを送信せず、インストールコマンドも実行しません。Howl showcase bundle では、ソースに基づくオフラインプレビューを提供しています。

10月22日の Commerce アップデートでは、Commerce 0.5.1、オプションの PostgreSQL 処理および Square 決済／復旧モジュール、バージョンを指定した正確な npm インストールコマンドを記録しています。高度な機能には引き続き承認ゲートが適用されます。MCP カタログは検出機能のみを提供し、決済もパッケージのインストールも実行しません。

テレメトリ

ホスト型サービスは、生のクエリや訪問者の識別情報を収集せず、日次の利用状況カウンターを集計して収集します。詳細、保存期間、オプトアウトの手順については、テレメトリに関する通知をご覧ください。