ls-mcp
List MCP Server configurations in your system used by AI applications like Cursor, Claude Desktop, VS Code and others
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/lirantal/ls-mcp with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/lirantal/ls-mcp'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/lirantal--ls-mcp)HTML
<a href="/listings/lirantal--ls-mcp"><img src="/api/listings/lirantal--ls-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 125 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <!-- markdownlint-disable -->
- <p align="center"><h1 align="center">
- ls-mcp
- </h1>
- </p>
- <p align="center">
- Detect Configured MCP (Model Context Protocol) in your local dev environment
- </p>
- <p align="center">
- <a href="https://www.npmjs.com/package/ls-mcp"><img src="https://badgen.net/npm/v/ls-mcp" alt="npm version"/></a>
- <a href="https://www.npmjs.com/package/ls-mcp"><img src="https://badgen.net/npm/license/ls-mcp" alt="license"/></a>
- <a href="https://www.npmjs.com/package/ls-mcp"><img src="https://badgen.net/npm/dt/ls-mcp" alt="downloads"/></a>
- <a href="https://github.com/lirantal/ls-mcp/actions/workflows/ci.yml"><img src="https://github.com/lirantal/ls-mcp/actions/workflows/ci.yml/badge.svg?branch=main" alt="build"/></a>
- <a href="https://app.codecov.io/gh/lirantal/ls-mcp"><img src="https://badgen.net/codecov/c/github/lirantal/ls-mcp" alt="codecov"/></a>
- <a href="./SECURITY.md"><img src="https://img.shields.io/badge/Security-Responsible%20Disclosure-yellow.svg" alt="Responsible Disclosure Policy" /></a>
- </p>
- <div align="center">
- <img src="https://raw.githubusercontent.com/lirantal/ls-mcp/refs/heads/main/.github/ls-mcp-logo.png" alt="ls-mcp logo"/>
- </div>
- ## Features
- - **🔍 MCP Discovery**: Automatically detect MCP servers across various AI applications and agentic IDEs
- - **📁 Directory Bubbling**: Intelligent discovery of project-scoped MCP configs from nested directories, supporting project-scoped MCP Server configuration and global configurations
- - **🔄 Process Detection**: Real-time status of running MCP servers
- - **🔒 Credential Analysis**: Security analysis of environment variables and API keys for potentially exposed credentials in MCP Servers
- ## Usage: CLI
- ```bash
- npx ls-mcp
- ```
- ### Analyze Specific Files
- To analyze specific MCP configuration files instead of using automatic discovery, use the `--files` flag. This flag **replaces** automatic discovery and only analyzes the files you specify:
- ```bash
- # 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
- ```
- The `--files` flag automatically detects the configuration structure in your files, supporting various formats including:
- - `servers` - Standard MCP configuration key
- - `mcpServers` - Alternative MCP configuration key
- - `mcp.servers` - Nested configuration format
- - `context_servers` - Context-based configuration format
- ### Show All Providers
- By default, `ls-mcp` hides providers that have zero configured servers to reduce clutter. To show all providers including those with empty configurations, use the `--all` or `-a` flag:
- ```bash
- # 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
- ```
- **Note**: When using `--files` to analyze specific configuration files, the custom group is always shown even if it contains zero servers, as you explicitly requested to analyze those files.
- ### JSON Output
- To output results in JSON format (useful for programmatic consumption):
- ```bash
- npx ls-mcp --json
- # Combine with --files flag
- npx ls-mcp --files ./config.json --json
- ```
- This will return a structured JSON object containing:
- - `mcpFiles`: Complete MCP server configurations organized by provider (only includes providers with configured servers unless `--all` is specified)
- - `summary`: Statistics including total servers, running servers, credential warnings, and transport breakdown
- ### Debug Mode
- To enable verbose debugging output, set the `NODE_DEBUG` environment variable:
- ```bash
- # Enable debug logging for ls-mcp
- NODE_DEBUG=ls-mcp npx ls-mcp
- # Enable all debug logging
- NODE_DEBUG=* npx ls-mcp
- ```
- ## Documentation
- For detailed information about the project architecture and features:
- - **[Project Overview](./docs/project.md)**: Comprehensive project analysis and architecture
- - **[Design Documentation](./docs/design.md)**: Technical design decisions and implementation details
- - **[Requirements](./docs/requirements.md)**: Functional and non-functional requirements
- - **[Custom File Analysis](./docs/custom-files-analysis.md)**: Analyze specific MCP configuration files with the `--files` flag
- - **[Directory Bubbling](./docs/directory-bubbling.md)**: Intelligent directory traversal feature
- - **[URL Hostname Extraction](./docs/url-hostname-extraction.md)**: Clean display of hostnames for URL-based servers
- - **[Credential Detection](./docs/credential-detection.md)**: Security analysis features
- ## Documentation
- - [Project documentation](./docs/README.md) - development, testing, architecture, and conventions.
- ## Contributing
- Please consult [CONTRIBUTING](./CONTRIBUTING.md) for guidelines on contributing to this project.
- ## Author
- **ls-mcp** © [Liran Tal](https://github.com/lirantal), Released under the [Apache-2.0](./LICENSE) License.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.