[OSS紹介#78] Smithery CLI:柔軟なAIクライアント管理を実現する強力なツール

この記事について

この記事では、注目のオープンソースソフトウェア(OSS)である「Smithery CLI」をご紹介します。このツールは、Model Context Protocol(MCP)サーバーのためのレジストリインストーラーおよびマネージャーとして設計されており、クライアントに依存しない仕様が特徴です。

近年、AI技術の進化に伴い、開発者はさまざまなAIクライアントとの連携において柔軟性を求めています。Smithery CLIは、そのニーズに応えるために、多様なAIクライアントを管理し、効果的な開発プロセスを実現します。本記事では、Smithery CLIの基本的な機能や利用シーンを掘り下げ、開発者にとっていかに役立つツールであるかを説明します。これにより、効果的なプロトタイピングや開発フローの改善が図れることでしょう。この記事を通じて、Smithery CLIがあなたの開発環境に新たな可能性をもたらすことを願っています。

リンク:https://github.com/smithery-ai/cli


本コンテンツは、弊社AI開発ツール「IXV」を用いたOSSツール紹介です。情報の正確性には努めておりますが、内容に誤りが含まれる可能性がございますのでご了承ください。

1. Smithery CLIの機能

Smithery CLIは、Model Context Protocol (MCP)サーバのためのレジストリインストーラおよびマネージャであり、クライアントに依存しない設計が特徴です。以下のコマンドを利用することで、さまざまな操作を行うことができます。

  • インストール (install <package>): パッケージをインストールします。--clientオプションでAIクライアントを指定し、--configオプションでJSON形式の設定データを提供することで、プロンプトをスキップできます。
  • アンインストール (uninstall <package>): 指定したパッケージをアンインストールします。
  • サーバの検査 (inspect <server-id>): 指定したサーバをインタラクティブに検査します。
  • サーバの実行 (run <server-id>): サーバを実行し、--configオプションで設定を提供できます。
  • クライアントやサーバのリスト表示: list clientsコマンドで利用可能なクライアントを、list servers --client <name>コマンドで特定のAIクライアントのインストール済みサーバをリストアップできます。
  • 開発サーバの起動 (dev [entryFile]): ホットリロード機能を持つ開発サーバを起動します。
  • 本番用のビルド (build [entryFile]): MCPサーバを本番用にビルドします。
  • プレイグラウンドのオープン (playground): ブラウザでMCPプレイグラウンドを開きます。

2. セットアップ手順

Smithery CLIを使用するための前提条件は以下の通りです。

  • 動作環境: NodeJSバージョン18以上が必要です。

npmでインストール

以下のコマンドを使用してSmithery CLIをインストールします。

npm install -g @smithery/cli

APIキーの設定

一部の操作にはSmitheryのAPIキーが必要です。以下のコマンドを利用してログインし、APIキーを設定します。

npx @smithery/cli login

3. 簡単な使い方

Smithery CLIの基本的な使い方を以下に示します。

サーバのインストール

指定したクライアント用のサーバをインストールする場合、次のようにコマンドを実行します。

npx @smithery/cli install mcp-obsidian --client claude

事前に設定データを指定する場合は、以下のようにします。

npx @smithery/cli install mcp-obsidian --client claude --config '{"vaultPath":"path/to/vault"}'

サーバの実行

インストールしたサーバを実行するには、次のコマンドを使用します。

npx @smithery/cli run mcp-obsidian --config '{"key":"value"}'

開発サーバの起動

開発作業を行う場合は、以下のコマンドでホットリロード機能を持つ開発サーバを起動できます。

npx @smithery/cli dev

プレイグラウンドの利用

ブラウザでMCPのプレイグラウンドを開くには、次のコマンドを使用します。

npx @smithery/cli playground

結論

Smithery CLIは、MCPサーバの管理を簡素化する強力なツールです。インストールから実行、開発に至るまで、幅広い機能を提供しており、特にAIクライアントと連携する際に便利です。Node.js環境が整っていることを前提に、簡単にセットアップし、迅速に開発を進めることができます。興味のある方はぜひ試してみてください。