mcp-server-tester について
Smithery Registry のインストールコードを使い、MCP サーバーの到達可否を調べる Node.js Web プロジェクトです。バックエンド API とフロントエンドを備え、API はサーバー情報またはエラーを返します。
主な機能
- 01インストールコードによるサーバー可用性確認
- 02Smithery Registry への問い合わせ
- 03サーバーデータまたは接続エラーの返却
- 04フロントエンドとバックエンドの構成
活用シーン
- 01レジストリ上の MCP サーバー可用性の確認
- 02サーバーのレジストリ情報の取得
- 03簡易 MCP サーバーチェック画面の構築
MCP 対応
API は受け取った installationCode で Smithery Registry を照会し、MCP サーバーへの到達可否を確認します。プロジェクト自体は MCP サーバーのインターフェースを提供しません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
プロジェクトのセットアップガイド
このガイドでは、プロジェクトのバックエンドとフロントエンドの両方をセットアップする手順を説明します。
ステップ 1:バックエンドのセットアップ
-
backendディレクトリに移動します。cd backend -
次のコマンドを実行して、必要な依存関係をインストールします。
npm install -
backendフォルダーに.envファイルを作成し、次の環境変数を追加します。PORT=5000 FRONTEND_URL=http://localhost:5173 -
次のコマンドを実行して、サーバーを起動します。
npm run devサーバーは
http://localhost:5000で起動します。
ステップ 2:フロントエンドのセットアップ
-
frontendディレクトリに移動します。cd frontend -
次のコマンドを実行して、必要な依存関係をインストールします。
npm install -
frontendフォルダーに.envファイルを作成し、次の環境変数を追加します。VITE_BACKEND_URL=http://localhost:5000 -
次のコマンドを実行して、クライアントを起動します。
npm run devクライアントは
http://localhost:5173で起動します。
追加情報
- バックエンドとフロントエンドの両方が同時に実行されていることを確認してください。
- バックエンドとフロントエンドのサーバーが両方とも起動したら、ブラウザーで
http://localhost:5173にアクセスして、アプリケーション全体をテストできます。
MCP サーバーチェック API
これは、リクエストボディで指定された installationCode を使って https://registry.smithery.ai/servers/{installationCode} エンドポイントに問い合わせ、MCP サーバーの可用性を確認する、シンプルな Node.js Express エンドポイントです。接続に成功すると、サーバーは成功メッセージとサーバーデータを返します。接続に失敗した場合は、エラーメッセージを返します。
エンドポイント
POST /test-server
リクエストボディ
{
"installationCode": "your-installation-code"
}
レスポンス
{
"success": true,
"message": "MCP Server is reachable",
"data": {
"qualifiedName": "server-qualified-name",
"displayName": "Server Display Name",
"deploymentUrl": "https://deployment-url.com",
"connections": [
{
"type": "http",
"url": "https://connection-url.com",
"configSchema": {}
}
]
}
}
詳細情報
詳細については、Smithery Registry ドキュメントをご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。