カタログ・レジストリコマンド

MCPサーバーの検索、インストール、コネクタ管理

catalog - MCPサーバーカタログ

公開されているMCPサーバーを検索・インストールします。

サブコマンド

MCPサーバーを検索します。

pfscan catalog search time
pfscan catalog search weather
pfscan catalog search filesystem

catalog view

MCPサーバーの詳細を表示します。

pfscan catalog view @modelcontextprotocol/server-time
pfscan catalog view @modelcontextprotocol/server-time --json

catalog install

MCPサーバーをインストールして設定に追加します。

# npmパッケージをインストール
pfscan catalog install @modelcontextprotocol/server-time --id time

# カスタムID指定
pfscan catalog install mcp-server-weather --id my-weather

catalog sources

カタログソースを管理します。

# ソース一覧
pfscan catalog sources

# ソース追加
pfscan catalog sources add --url https://registry.example.com/catalog.json

# ソース削除
pfscan catalog sources remove --url https://registry.example.com/catalog.json

使用例

# 1. 検索
pfscan catalog search time

# 2. 詳細確認
pfscan catalog view @modelcontextprotocol/server-time

# 3. インストール
pfscan catalog install @modelcontextprotocol/server-time --id time

# 4. 動作確認
pfscan scan start --id time

connectors - コネクタ管理

MCPサーバー接続設定（コネクタ）を管理します。

サブコマンド

connectors list

登録されているコネクタの一覧を表示します。

pfscan connectors list
pfscan connectors list --json

出力例：

Connectors:
  time       ✓ enabled   stdio  npx -y @modelcontextprotocol/server-time
  weather    ✓ enabled   stdio  npx -y mcp-server-weather
  inscribe   ✗ disabled  stdio  npx -y @proofofprotocol/inscribe-mcp-server

connectors show

コネクタの詳細情報を表示します。

pfscan connectors show --id time
pfscan connectors show --id time --json

connectors add

新しいコネクタを追加します。

# stdio トランスポート
pfscan connectors add --id myserver --stdio "npx -y mcp-server"

# カスタム引数付き
pfscan connectors add --id myserver --stdio "uvx mcp-server --port 3000"

connectors enable/disable

コネクタの有効/無効を切り替えます。

pfscan connectors enable --id time
pfscan connectors disable --id time

connectors remove

コネクタを削除します。

pfscan connectors remove --id time

connectors import

Claude Desktopやmcp.soの設定からコネクタをインポートします。

# ファイルからインポート
pfscan connectors import --from mcpServers --file config.json

# 標準入力からインポート
cat claude_desktop_config.json | pfscan connectors import --from mcpServers --stdin

# 特定のJSONキーを指定
cat config.json | pfscan connectors import --from mcpServers --stdin --key mcpServers

インポート形式：

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-time"]
    },
    "weather": {
      "command": "uvx",
      "args": ["mcp-server-weather"]
    }
  }
}

registry - ローカルコネクタ探索

ローカルにインストール済みのMCPサーバーを探索します。

基本的な使い方

# ローカルレジストリをスキャン
pfscan registry scan

# 検出されたサーバーを表示
pfscan registry list

# JSON形式で出力
pfscan registry list --json

検出対象

  • グローバルにインストールされたnpmパッケージ
  • ユーザーディレクトリのPythonパッケージ
  • Claude Desktop設定ファイル
  • mcp.so設定ファイル

runners - パッケージランナー管理

npx、uvxなどのパッケージランナーを管理します。

サブコマンド

runners list

使用可能なランナーの一覧を表示します。

pfscan runners list

出力例：

Package Runners:
  npx    ✓ available    /usr/local/bin/npx    (npm 9.6.7)
  uvx    ✓ available    /usr/local/bin/uvx    (uv 0.1.2)
  bunx   ✗ not found

runners check

特定のランナーの詳細を確認します。

pfscan runners check npx
pfscan runners check uvx --json

サポートされるランナー

ランナー 説明 インストール方法
npx Node.js パッケージランナー Node.jsに付属
uvx Python パッケージランナー pip install uv
bunx Bun パッケージランナー bun.sh

sessions - セッション管理

スキャンセッションを管理します。

サブコマンド

sessions list

セッションの一覧を表示します。

# 全セッション
pfscan sessions list

# コネクタでフィルタ
pfscan sessions list --connector time

# 最新N件
pfscan sessions list --last 10

# JSON形式
pfscan sessions list --json

sessions show

セッションの詳細を表示します。

pfscan sessions show --id f2442c9b
pfscan sessions show --id abc --json  # 部分IDも使用可能

sessions prune

古いセッションを削除します。

# 日付より前のセッションを削除
pfscan sessions prune --before 2026-01-01

# 各コネクタで最新N件を保持
pfscan sessions prune --keep-last 50

# 実際に削除（デフォルトはドライラン）
pfscan sessions prune --keep-last 50 --yes

よくあるワークフロー

初回セットアップ

# 1. 設定を初期化
pfscan config init

# 2. Claude Desktop設定をインポート
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | \
  pfscan connectors import --from mcpServers --stdin

# 3. 確認
pfscan connectors list
pfscan status

新しいMCPサーバーの追加

# オプション A: カタログから検索してインストール
pfscan catalog search weather
pfscan catalog install mcp-server-weather --id weather

# オプション B: 手動で追加
pfscan connectors add --id weather --stdio "npx -y mcp-server-weather"

# オプション C: Catalog経由で自動セットアップ
pfscan catalog install @modelcontextprotocol/server-time --id time

メンテナンス

# コネクタ一覧を確認
pfscan connectors list

# 使っていないコネクタを無効化
pfscan connectors disable --id old-server

# 古いセッションを削除
pfscan sessions prune --keep-last 30 --yes

# システムステータス確認
pfscan status

よくある質問

Q. カタログでサーバーが見つからない

A. カタログソースを追加するか、手動でコネクタを追加してください：

pfscan connectors add --id myserver --stdio "npx -y my-mcp-server"

Q. コネクタが動作しない

A. 以下を確認してください：

  • コネクタが有効になっているか: pfscan connectors list
  • コマンドが正しいか: pfscan connectors show --id <id>
  • ランナーが利用可能か: pfscan runners list
  • 手動でテスト: pfscan scan start --id <id>

Q. Claude Desktop設定をインポートできない

A. 設定ファイルのパスと形式を確認してください：

# macOS
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | \
  pfscan connectors import --from mcpServers --stdin

# Windows
type %APPDATA%\Claude\claude_desktop_config.json | \
  pfscan connectors import --from mcpServers --stdin