Artifact Hub

Artifact Hub は、チーム向けの Agent ナレッジベースおよび MCP Server です。Git を使用して再利用可能な知識成果物を保存し、IDE と Agent に MCP ツールを公開し、知識の閲覧、レビュー、使用状況を確認できる Dashboard を提供します。

従来の skill registry として使い続けることも、Agent の各セッションで生成される skill、spec、plan、review、adr を蓄積する中央集権型 AI ナレッジベースとしても利用できます。

クイックスタート

npm install
npm run build
node packages/server/src/cli.js start --port 3721 --root .

サービス起動後にアクセストークンが出力され、以下が公開されます：

• Dashboard: http://localhost:3721

• REST API: /api/*

• MCP HTTP endpoint: /mcp

Dashboard に起動時に出力されたトークンを入力すると接続できます。

Related MCP server: jt-mcp-server

グローバルインストール

リポジトリのルートで以下を実行します：

npm link

以降、ローカルで直接 artifact-hub コマンドを使用できるほか、他のプロジェクトでも npx artifact-hub で呼び出すことができます。

中央集権型 Agent ナレッジベース

チームは Artifact Hub を中央集権型 MCP Server としてデプロイできます。Git 内の knowledge/** が事実源（source of truth）です：

knowledge/
  skill/<id>.md
  spec/<id>.md
  plan/<id>.md
  review/<id>.md
  adr/<id>.md

サポートされる知識成果物の種類：

• skill: 再利用可能な操作スキル、エンジニアリング規範、ツールの使用方法。

• spec: 製品、インターフェース、プロセス、データモデルなどの仕様書。

• plan: 再利用可能な実行計画、移行計画、実装手順。

• review: コードレビュー、設計レビュー、リスクレビューの知見。

• adr: アーキテクチャ決定記録。決定ステータスと置き換えられた決定を含みます。

Agent 推奨ワークフロー：

1. 初回接続時に get_agent_instructions を呼び出し、チームのナレッジベース利用ルールを取得します。

2. 大規模なタスクを開始する際に session_start を呼び出してセッションを記録します。

3. 再利用可能なコンテンツを生成する前に search_artifacts を呼び出し、知識の重複作成を避けます。

4. 関連する知識が見つかったら get_artifact を呼び出して完全なコンテンツを読み込みます。

5. 新しい再利用可能な skill、spec、plan、review、adr を生成したら、create_artifact または update_artifact を呼び出して保存します。

6. タスク終了前に session_end を呼び出し、システムが今回のセッションで蓄積された成果物を記録できるようにします。

Agent に積極的に使用させる方法

artifact-hub install は、MCP 設定と Agent 指示をプロジェクトがサポートする IDE/Agent の設定場所に書き込みます。例：

• Claude Code: CLAUDE.md

• Codex / 汎用 Agent: AGENTS.md

• Cursor: .cursor/rules/knowledge-hub.mdc

これらの指示により、Agent は再利用可能な作業を開始する前にナレッジベースを検索し、再利用可能なコンテンツを生成した後は知識成果物を保存するよう要求されます。MCP Server は get_agent_instructions ツールも提供しており、動的ツール呼び出しをサポートする Agent は実行時にルールを再度取得できます。

使用状況は .artifact-hub/usage.json に記録され、Dashboard の「使用状況」ページで Agent の session、search、write の統計を確認できます。チームが実際にナレッジベースを再利用しているかを観察するために使用します。

IDE へのインストール

ワンクリックで MCP 設定と Agent 指示を書き込みます：

artifact-hub install --server http://localhost:3721 --token <token>

特定の IDE の MCP 設定のみを生成することもできます：

node packages/server/src/cli.js init-ide --ide cursor --server http://localhost:3721 --token <token>
node packages/server/src/cli.js init-ide --ide claude --server http://localhost:3721 --token <token>

Cursor には .cursor/mcp.json が書き込まれ、Claude Code には .mcp.json が書き込まれます。設定は MCP HTTP endpoint を指します：

{
  "mcpServers": {
    "team-artifact-hub": {
      "url": "http://localhost:3721/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

IDE が stdio bridge のみをサポートする場合は、プロキシ設定を生成できます：

node packages/server/src/cli.js init-ide --transport stdio --ide cursor --server http://localhost:3721 --token <token>

知識成果物の形式

各知識成果物は frontmatter 付きの Markdown ファイルです：

---
id: api-contract
type: spec
title: API Contract
status: active
version: 1.0.0
author: agent
owner: platform
description: REST API contract rules.
tags:
  - api
  - backend
aliases:
  - rest contract
related_artifacts:
  - adr/http-style
applicable_projects:
  - billing-service
source_conversation_id: session-1
review_policy: reviewer
risk: medium
created_at: 2026-08-20T00:00:00.000Z
updated_at: 2026-08-20T00:00:00.000Z
---

# API Contract

Use resource-oriented URLs and stable response envelopes.

共通フィールドは以下のとおりです：

• id、type、title、status、version

• author、owner、description

• tags、aliases、related_artifacts

• applicable_projects、source_conversation_id

• review_policy、risk、created_at、updated_at

skill は追加で triggers と eval_cases をサポートし、adr は追加で decision_status と supersedes をサポートします。

MCP ツール

汎用ナレッジベースツール：

• get_agent_instructions: Agent が従わなければならないナレッジベース利用ルールを取得します。

• session_start: Agent セッションの開始を記録します。

• session_end: Agent セッションの終了と今回の蓄積内容を記録します。

• search_artifacts: タイプ、プロジェクト、タグ、エイリアス、ステータス、キーワードで知識成果物を検索します。

• get_artifact: 完全な知識成果物を読み取ります。

• get_related_artifacts: 関連する知識成果物のレコメンデーションを取得します。

• create_artifact: 新しい知識成果物を作成します。

• update_artifact: 知識成果物を更新します。

• archive_artifact: 知識成果物をアーカイブします。

• delete_artifact: 知識成果物を削除します。

• get_artifact_history: Git 履歴を表示します。

• get_artifact_diff: バージョン差分を表示します。

• rollback_artifact: 指定した Git ref にロールバックします。

• validate_artifact: ルールベースの Reviewer チェックを実行します。

• propose_artifact_change: 知識成果物の変更レビューを提出します。

• list_review_tasks: レビュータスクを表示します。

• review_artifact: 承認、拒否、またはエスカレーションを記録します。

• evaluate_artifact: skill タイプに対して eval cases を実行します。

• get_git_status: ナレッジベースの Git ステータスを表示します。

旧 skill API と互換性のあるツールも引き続き利用できます：

• search_skills

• get_skill

• create_skill

• update_skill

• propose_skill_update

• evaluate_skill

• save_artifact

Dashboard

Dashboard は現在、ナレッジベースをメインの入り口としています：

• 「ナレッジベース」ページ：skill/spec/plan/review/adr の検索と閲覧。

• 「レビュー」ページ：保留中のレビュータスクを確認し、承認または拒否を実行。

• 「使用状況」ページ：Agent のセッション、検索、書き込みの統計を確認。

• 「設定」ページ：MCP 設定の確認、厳格な承認モードとオープン書き込みモードの切り替え。

移行

旧バージョンの skills/*.md は新しいナレッジベースディレクトリに移行できます：

artifact-hub migrate --root .

このコマンドは、旧スキルを knowledge/skill/*.md に書き込み、元のコンテンツを保持し、frontmatter に移行情報をマークします。

ガバナンス

サービスはデフォルトで厳格モードです：

• 高リスクまたはレビューが必要な artifact の書き込みは .artifact-hub/reviews/ に入ります。

• Maintainer は Dashboard の「レビュー」ページで承認または拒否できます。

• 設定は <root>/.artifact-hub/settings.json に保存されます。

オープンモードに切り替えると、追加と変更は Git-backed の knowledge store に直接書き込まれます。

開発

API Server と Vite Dev Server をそれぞれ起動します：

node packages/server/src/cli.js start --port 3721 --root .
npm run dev

Vite は http://localhost:5173 で実行され、/api をバックエンドにプロキシします。

アーキテクチャ

• packages/core: artifact frontmatter、インデックス、Git service、store、review、session usage、eval。

• packages/mcp-server: JSON-RPC MCP router、HTTP gateway、stdio proxy。

• packages/server: REST API、SSE、静的 Dashboard、CLI。

• packages/web: React + Vite Dashboard。

テスト

npm test
npm run build

ライセンス

このプロジェクトは MIT License を使用しています。詳細は LICENSE を参照してください。

よく使うコマンド

node packages/server/src/cli.js start --port 3721 --root .
artifact-hub install --server http://localhost:3721 --token <token>
artifact-hub migrate --root .
node packages/server/src/cli.js mcp-proxy --server http://localhost:3721 --token <token>