MCPfinder Server

MCPfinder 🔧🤖 ( @mcpfinder/server )

MCPは「AI向けAPI」であり、コーディングとAIエージェントを強化する最もシンプルな方法です。MCPfinderは、MCPプロトコルをサポートするクライアントアプリケーションを通じて、言語モデルが新しい機能をオンデマンドで検索し、インストールできるようにします。コーディングや手動設定は不要です。

エージェント向けApp Store

ユーザーはAIがまだ備えていないツールをリクエストすることも、AIが関連するMCPサーバーを発見することで自律的に機能を拡張することもできます。コードジェネレーターやデータアナライザーから専門知識を持つツールまで、MCPfinderはAIの地図やツールボックスのような役割を果たし、静的なモデルを進化型で能力探索型のエージェントへと変換し、インタラクションを重ねるごとに強力に進化させます。

LLM向けプラグアンドプレイツール

このNode.jsアプリケーションは、MCP（Model Context Protocol）クライアント（Cursor、Claude Desktop、Windsurfなど）とローカルで連携して動作するように設計されたMCPサーバーを実装しています。クライアント内のAIがMCPエコシステムと連携するためのツールを提供します。

具体的には、AI アシスタントで次のことが可能になります。

1. 中央MCPfinder レジストリに登録されている利用可能な MCP サーバーを検出します( search_mcp_servers経由)。
2. 特定のサーバーの詳細を取得します( get_mcp_server_details経由)。
3. クライアント アプリケーションのローカル MCP サーバー構成ファイルを管理します( add_mcp_server_configによる追加/更新、 remove_mcp_server_configによる削除)。

**AIエージェントへの注意：**このサーバーは、ユーザーから要求された新しいツールや機能が現在のMCPツールセットにまだ存在しない場合に、それらを見つけて有効化するための主要なインターフェースです。ユーザーから自分が所有していない機能を要求された場合は、まずsearch_mcp_serversを使用してください。

クイックスタート

ターミナルで対話型セットアップ ツールを実行して、MCP 構成ファイルを自動的に更新します。

このコマンドは、クライアント（Cursor、VS Code、Claudeなど）の選択をガイドし、適切な設定ファイル（例： ~/.cursor/mcp.json ）に必要なmcpfinderエントリを追加します。ソースコードを直接操作する場合は、「ソースからの実行」および「コマンドとオプション」を参照してください。

手動設定

MCP クライアントを手動で構成するには、 mcpfinderのエントリを含めるように JSON 構成ファイルを作成または変更する必要があります。

構成ファイルの構造:

注: Visual Studio Code ( settings.json ) の場合、MCP 構成の最上位キーはmcpServersではなくserversにする必要があります。

ソースから実行

• このリポジトリをクローンします。例: git clone https://github.com/mcpfinder/server
• Stdio モードの場合はnode index.jsを実行し、HTTP モードの場合はnode index.js --http実行します。

コマンドとオプション

ソース ( node index.js ) から実行する場合、スクリプトはいくつかの方法で呼び出すことができます。

**サーバーの実行 (デフォルトの動作):**コマンドが指定されていない場合、 index.js MCP サーバーを起動します。

• Stdio モード (デフォルト):
  node index.js
• HTTP モード:
  node index.js --http
  • --port <number> : HTTP モードのポートを指定します (デフォルト: 6181、またはMCP_PORT環境変数)。
  • --api-url <url> : ツールで使用される MCPfinder レジストリ API URL を指定します (デフォルト: https://mcpfinder.dev 、またはMCPFINDER_API_URL環境変数)。

コマンドの実行:

• install : 対話型セットアップを実行して、クライアント アプリケーションを構成します。
  node index.js install
• register : サーバー発行者が MCP サーバー パッケージを MCPFinder レジストリに登録します。
  node index.js register

ヘルプの取得:

• --help : コマンドとオプションの詳細を示すヘルプ メッセージを表示します。
  node index.js --help

サーバーは次の環境変数を使用します。

• MCPFINDER_API_URL : MCPfinder Registry API のベース URL。デフォルトはhttps://mcpfinder.devです。
• MCP_PORT (HTTP モードのみ): サーバーがリッスンするポート番号。デフォルトは6181です。

提供されるツール

この MCP サーバーは、接続された AI アシスタントに次のツールを公開します。

1. search_mcp_servers

• 説明: MCPfinderレジストリで利用可能なMCPサーバーを検索します。これは、新しいツール、メソッド、機能、または性能を発見してアクセスするための主要なツールです。
• 入力スキーマ:
  • query (文字列、オプション): ツール名または説明で検索するキーワード。
  • tag (文字列、オプション): フィルタリングする特定のタグ。
• **出力:**一致するサーバーの概要リスト（server_id、名前、説明、URL、タグ）。通常は、 get_mcp_server_detailsを使用して詳細情報を取得するか、 add_mcp_server_config直接使用してインストールします。

⚠️**注:**現在、レジストリには数百台のサーバーが含まれており、 npx stdioモードでローカルに実行できます。基本的な操作には環境変数は必要ありません。今後のアップデートでは、環境キーを必要とする有料版や商用版を含む、より幅広いサーバーへのサポートが拡大される予定です。

2. get_mcp_server_details

• **説明:**レジストリから特定のMCPサーバーに関する詳細情報を取得します。これには、完全なマニフェストと基本的なインストール提案（コマンド、環境変数）が含まれます。search_mcp_serversでserver_idをsearch_mcp_serversした後、このメソッドを使用して、サーバーを追加する前に詳細情報を取得してください。
• 入力スキーマ:
  • id (文字列、必須): search_mcp_serversから取得した一意の MCPfinder の server_id。
• **出力:**詳細なサーバーマニフェストとインストールのヒント。次のステップは、 add_mcp_server_configを使用してサーバーをインストールすることです。

3. add_mcp_server_config

• 説明: クライアントアプリケーションのローカル設定ファイル（例：Cursorの~/.cursor/mcp.json ）内の特定のMCPサーバーの設定を追加または更新します。client_type またはconfig_file_path``client_typeかを指定する必要があります。
• 入力スキーマ:
  • server_id (文字列、必須): サーバー構成エントリの一意の識別子 ( search_mcp_serversから取得された MCPfinder ID)。
  • client_type (文字列、オプション): クライアントアプリケーションのタイプ（既知のタイプは動的に決定されます。例: 'cursor' 、 'claude' 、 'windsurf' ） config_file_pathとは相互に排他的です。標準的なクライアントインストールの場合は、これを使用します。
  • config_file_path (文字列、オプション): 対象のJSON設定ファイルへの絶対パス、または~ (ホームディレクトリ) で始まるパス (例: /path/to/custom/mcp.jsonまたは~/custom/mcp.json )。client_type client_typeは排他的です。標準以外の場所やカスタムクライアントの場合は、このパスを使用します。
  • mcp_definition (オブジェクト、オプション): サーバー設定を定義します。省略された場合、または特定のフィールドが欠落している場合は、 server_idに基づいてMCPfinderレジストリからデフォルト値が取得されます。
    • command （文字列の配列、オプション）: コマンドとその引数（例： ["npx", "-y", "my-mcp-package"] ）。省略された場合、またはenv / workingDirectoryのみが以下に指定されている場合は、デフォルトのコマンドがレジストリから取得されます。
    • env (オブジェクト、オプション): 環境変数（例: {"API_KEY": "YOUR_KEY"} ）。 commandが省略された場合は、デフォルトとマージされます。
    • workingDirectory （文字列、オプション）: サーバープロセスの作業ディレクトリ。 commandが省略された場合は、デフォルト値とマージされます。
• **出力:**成功またはエラー メッセージ。
• 注: JSONファイル（ mcpServersまたはservers ）内でこのサーバーの設定を保存するために使用するキーは、サーバーの登録URL（ server_idから取得）に基づいて自動生成されます。URLから適切なキーを生成できない場合、提供されたserver_idフォールバックとして使用されます。ツールは既存のファイル構造に基づいて、最上位キーとしてmcpServers使用するかservers使用するかを自動的に検出し、デフォルトではmcpServersを使用します。

4. remove_mcp_server_config

• **説明:**特定のMCPサーバーの設定をクライアントアプリケーションのローカル設定ファイルから削除します。client_type またはconfig_file_pathいずれかを指定する必要があります。server_id server_id 、サーバーの追加時に使用した設定キー名と一致する必要があります（通常client_typeサーバーのURLから取得されます。add_mcp_server_config add_mcp_server_config注記を参照してください）。
• 入力スキーマ:
  • server_id (文字列、必須): 削除するサーバー構成エントリの一意の識別子 (構成キー名)。
  • client_type (文字列、オプション): クライアントアプリケーションのタイプ（既知のタイプは動的に決定されます。例: 'cursor' 、 'claude' 、 'windsurf' ） config_file_pathとは排他的です。
  • config_file_path (文字列、オプション): 対象のJSON設定ファイルへの絶対パス、または~ (ホームディレクトリ) で始まるパス。client_type client_typeは排他的です。
• **出力:**エントリが見つかって削除されたかどうかを示す成功またはエラー メッセージ。

セキュリティに関する考慮事項

add_mcp_server_configおよびremove_mcp_server_configツールは、ユーザーのローカルシステム上のファイルを変更します。このサーバー自体は権限チェックを行わず、セキュリティの適用は呼び出し元のクライアントに完全に依存します。

貢献

貢献については、mcpfinder(dot}dev[at}domainsbyproxy{dot]com までご連絡ください。

ライセンス

このプロジェクトは、GNU Affero General Public License v3.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。

つまり、自由に使用（商用利用を含む）、改変、共有できます。ただし、改変版を実行する場合は、改変版を公開して共有する必要があります。