/ ディレクトリ / プレイグラウンド / Smithery CLI
● 公式 smithery-ai ⚡ 即起動

Smithery CLI

作者 smithery-ai · smithery-ai/cli

公式SmitheryCLI — smithery install <server> でMCPをクライアント設定に追加でき、自分のMCPを開発するためのdevモードも搭載。

Smitheryは公開MCPサーバーのレジストリをホストしています。このCLIでクライアント設定に対してインストール/アンインストールを実行し、インストール済みサーバーを一覧表示し、公開用の新規MCPをスキャフォールドできます。

なぜ使うのか

主な機能

ライブデモ

実際の動作

準備完了

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "smithery-cli",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "smithery-cli": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@smithery/cli"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add smithery-cli -- npx -y @smithery/cli

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: Smithery CLI

手動でconfigを編集せずにMCPをインストールする

👤 開発者 ⏱ ~15 min intermediate

使うタイミング: stdio configの手動マージに疲れた場合。

フロー
  1. ブラウズ
    smithery search <topic>✓ コピーしました
    → マッチしたものが一覧表示されている
  2. インストール
    smithery install <slug>✓ コピーしました
    → configが編集されている;クライアントを再起動
  3. 確認
    smithery list✓ コピーしました
    → サーバーが存在している

結果: config調査なしに新しいMCPがインストールされます。

組み合わせ

他のMCPと組み合わせて10倍の力を

smithery-cli + mcp2cli

Smitheryでインストールしたあと、mcp2cliで直接デバッグする

smithery-cliとmcp2cliを組み合わせる:Smitheryでインストールしたあと、mcp2cliで直接デバッグする✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
CLI subcommands (ドキュメント参照) install / uninstall / list / dev / publish 1 call

コストと制限

運用コスト

APIクォータ
N/A
呼び出しあたりのトークン
N/A
金額
無料
ヒント
バージョンを固定する — slugのみだと最新版を追跡します

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: クライアントのconfigファイルを編集します
データ送信先: smithery.aiにアクセスしてレジストリを取得
絶対に付与しない: ツール一覧を確認せずに無闇にインストールすること

トラブルシューティング

よくあるエラーと対処法

configが見つからない

--config-pathを指定してください;CLIはデフォルトを推測しますが、OSによって異なります

代替案

Smithery CLI 他との比較

代替案代わりに使う場面トレードオフ
手動でconfigを編集完全なコントロールが必要な場合手間が増える

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る