mcpField
L
ls-mcp

ls-mcp

ローカル
github.com/lirantal開発ツール841 日前に更新
リポジトリ

ls-mcp について

ls-mcp は、ローカルの開発環境に設定された MCP サーバーを検出するコマンドラインツールです。複数の AI アプリケーションやエージェント型 IDE にまたがる MCP 設定を確認したい開発者を対象としています。サーバーの環境変数や API キーに含まれる、露出の可能性がある認証情報も分析します。

主な機能

  1. 01AI アプリやエージェント型 IDE 全体の自動検出
  2. 02ネストしたディレクトリのプロジェクト単位設定の探索
  3. 03MCP サーバープロセスの実行状態の検出
  4. 04環境変数に含まれる認証情報の分析
  5. 05プログラムから利用できる JSON 出力

活用シーン

  1. 01ローカルの各クライアントに設定された MCP サーバーの確認
  2. 02MCP 設定ファイルに平文の認証情報がないかの確認
  3. 03JSON 出力を使った設定情報のスクリプト連携

MCP 対応

このプロジェクトは MCP サーバーには接続せず、対応アプリケーションの MCP 設定ファイルを読み取り、定義されたサーバーとトランスポートを要約します。

#mcp#cursor#claude-ai#claude-desktop#cursor-ai#model-context-protocol#mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "ls": {
      "command": "npx",
      "args": [
        "-y",
        "ls-mcp"
      ]
    }
  }
}
起動コマンドnpx -y ls-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmls-mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

ls-mcp

ローカルの開発環境に設定されている MCP（Model Context Protocol）を検出します

npm バージョン ライセンス ダウンロード数 ビルド codecov 責任ある情報開示ポリシー

ls-mcp のロゴ

特長

  • 🔍 MCP の検出：さまざまな AI アプリケーションやエージェント型 IDE にわたって MCP サーバーを自動的に検出します
  • 📁 ディレクトリの遡及検索：ネストされたディレクトリからプロジェクト単位の MCP 設定をインテリジェントに検出し、プロジェクト単位の MCP サーバー設定とグローバル設定をサポートします
  • 🔄 プロセスの検出：実行中の MCP サーバーのステータスをリアルタイムで表示します
  • 🔒 認証情報の分析：MCP サーバーで認証情報が露出している可能性について、環境変数と API キーのセキュリティ分析を行います

使用方法：CLI

npx ls-mcp
特定のファイルを分析する

自動検出ではなく、特定の MCP 設定ファイルを分析するには、--files フラグを使用します。このフラグを指定すると、自動検出は置き換えられ、指定したファイルのみが分析されます。

# Single file
npx ls-mcp --files ./mcp-config.json

# Multiple files (comma-separated)
npx ls-mcp --files ./config1.json,./config2.json

# Multiple files (space-separated)
npx ls-mcp --files ./config1.json ./config2.json

--files フラグは、ファイル内の設定構造を自動的に検出し、次のようなさまざまな形式をサポートします。

  • servers - 標準の MCP 設定キー
  • mcpServers - 代替の MCP 設定キー
  • mcp.servers - ネストされた設定形式
  • context_servers - コンテキストベースの設定形式
すべてのプロバイダーを表示する

デフォルトでは、表示が煩雑にならないよう、設定済みのサーバーが 0 件のプロバイダーは ls-mcp に表示されません。空の設定を含むすべてのプロバイダーを表示するには、--all または -a フラグを使用します。

# Show all providers including empty ones
npx ls-mcp --all

# Short form
npx ls-mcp -a

# Combine with JSON output
npx ls-mcp --all --json

注：--files を使用して特定の設定ファイルを分析する場合、明示的にそれらのファイルの分析を指定しているため、サーバーが 0 件でもカスタムグループは常に表示されます。

JSON 出力

結果を JSON 形式で出力するには（プログラムからの利用に便利です）。

npx ls-mcp --json

# Combine with --files flag
npx ls-mcp --files ./config.json --json

次の内容を含む構造化された JSON オブジェクトが返されます。

  • mcpFiles：プロバイダーごとに整理された MCP サーバー設定全体（--all を指定しない限り、設定済みサーバーがあるプロバイダーのみを含みます）
  • summary：サーバーの合計数、実行中のサーバー数、認証情報に関する警告、トランスポートの内訳などの統計情報
デバッグモード

詳細なデバッグ出力を有効にするには、NODE_DEBUG 環境変数を設定します。

# Enable debug logging for ls-mcp
NODE_DEBUG=ls-mcp npx ls-mcp

# Enable all debug logging
NODE_DEBUG=* npx ls-mcp

ドキュメント

プロジェクトのアーキテクチャと機能の詳細については、以下を参照してください。

ドキュメント

コントリビューション

このプロジェクトへのコントリビューションに関するガイドラインは、CONTRIBUTINGを参照してください。

作者

ls-mcp © Liran Tal、Apache-2.0ライセンスの下で公開されています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。