freshcrate
Skin:/
Language:English/简体中文
Home > MCP Servers > ls-mcp

ls-mcp

List MCP Server configurations in your system used by AI applications like Cursor, Claude Desktop, VS Code and others

claude-aiclaude-desktopcursorcursor-aimcpmcp-servermodel-context-protocoltypescript
Why this rank:Strong adoptionHealthy release cadenceRelease freshness

Description

List MCP Server configurations in your system used by AI applications like Cursor, Claude Desktop, VS Code and others

README

ls-mcp

Detect Configured MCP (Model Context Protocol) in your local dev environment

npm version license downloads build codecov Known Vulnerabilities Responsible Disclosure Policy

ls-mcp logo

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

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:

# 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:

# 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):

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:

# 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:

Author

ls-mcp © Liran Tal, Released under the Apache-2.0 License.

Release History

VersionChangesUrgencyDate
v1.15.2### Patch Changes - [`d509e68`](https://github.com/lirantal/ls-mcp/commit/d509e68b225d92f77df0abe3f377901c337c6d7e) Thanks [@lirantal](https://github.com/lirantal)! - fix: output change related to group dividers Low11/22/2025
v1.15.1### Patch Changes - [`5aadbe3`](https://github.com/lirantal/ls-mcp/commit/5aadbe3d896f2cff7b8df22ef8fc404f80774bb1) Thanks [@lirantal](https://github.com/lirantal)! - fix: default shouldnt show empty servers even from same group Low11/22/2025
v1.15.0### Minor Changes - [`bb365f8`](https://github.com/lirantal/ls-mcp/commit/bb365f8764678f6f2ee0e0636fe09c7adfaf078a) Thanks [@lirantal](https://github.com/lirantal)! - feat: new --all flag to list all servers including empty Low11/22/2025
v1.14.0### Minor Changes - [`de16acf`](https://github.com/lirantal/ls-mcp/commit/de16acf45a7041d63d19bfec41b6ee3a6ce9c64b) Thanks [@lirantal](https://github.com/lirantal)! - feat: support --files arg Low11/22/2025
v1.13.3### Patch Changes - [`15d2921`](https://github.com/lirantal/ls-mcp/commit/15d29212b86511b133aaefd582317ef565a1b700) Thanks [@lirantal](https://github.com/lirantal)! - refactor: adds agent-files as third-party dep Low10/28/2025
v1.13.2### Patch Changes - [`0adda16`](https://github.com/lirantal/ls-mcp/commit/0adda16eb3bfb560ea6cb9a216394fe99776553d) Thanks [@lirantal](https://github.com/lirantal)! - feat: add --json flag Low10/10/2025
v1.13.1### Patch Changes - [`81a7d48`](https://github.com/lirantal/ls-mcp/commit/81a7d48ccfa47080d3c0126e38f6fc5250dc4720) Thanks [@lirantal](https://github.com/lirantal)! - fix: clean up progress bar to green if no security issues detected Low10/1/2025
v1.13.0### Minor Changes - [`bc64f95`](https://github.com/lirantal/ls-mcp/commit/bc64f9580576f53c340b2b9325e7818ea27725c6) Thanks [@lirantal](https://github.com/lirantal)! - feat: support for detecting pinned versions in python MCP servers Low10/1/2025
v1.12.0### Minor Changes - [`7ce808b`](https://github.com/lirantal/ls-mcp/commit/7ce808bcd5d69175f5d894a7f09ce9a43aada683) Thanks [@lirantal](https://github.com/lirantal)! - feat: better credentials and linux OS support Low10/1/2025
v1.11.0### Minor Changes - [`a3f6b4c`](https://github.com/lirantal/ls-mcp/commit/a3f6b4c36a6b6f08df3383a5941c3d9198f520b1) Thanks [@lirantal](https://github.com/lirantal)! - feat: detect URL sources Low8/23/2025
v1.10.0### Minor Changes - [`efc2985`](https://github.com/lirantal/ls-mcp/commit/efc29852f75df45f2ce230e49109254b9d2b0160) Thanks [@lirantal](https://github.com/lirantal)! - feat: automatically infer transport types, print summary results, and detect potential sensitive creds in MCP Server config files Low8/23/2025
v1.9.1### Patch Changes - 1c07a39: feat: path lookup refactors Low8/7/2025
v1.9.0### Minor Changes - 9d90487: feat: intellij support, mcp server defs, deps update and env variables update Low8/7/2025
v1.8.2### Patch Changes - 1bb0b15: feat: support MCP Servers in Zed IDe Low7/13/2025
v1.8.1### Patch Changes - eea5580: feat: support for Claude Code MCP server relative in directory Low6/20/2025
v1.8.0### Minor Changes - 419bdf1: Improve detection for Cursor and VS Code as parent applications of the MCP Servers Low6/12/2025
v1.7.0### Minor Changes - 04c616b: Show transport for non-stdio and show command or url source Low6/8/2025
v1.6.1### Patch Changes - 8f4536c: README update and JSON parsing support for VS Code settings file Low6/7/2025
v1.6.0### Minor Changes - a8fed5a: Print server locality (local vs remote) Low6/6/2025
v1.5.1### Patch Changes - 7445c4b: Add detection for GitHub Copilot in InteliJ Low6/6/2025
v1.5.0### Minor Changes - e7faa78: Expanded MCP clients detection for Windsurf, Cline, Roo, VS Code and bug fix to prevent duplicate file detection Low6/6/2025
v1.4.0### Minor Changes - ec83a1d: Windows support Low6/5/2025
v1.3.1### Patch Changes - aae6721: Windows support WIP Low6/3/2025
v1.3.0### Minor Changes - 3620547: General availability introducing mcp support and fixes for public adoption Low6/3/2025
v1.2.0### Minor Changes - 322b044: New UI and statistics presentation Low6/1/2025
v1.1.0### Minor Changes - 8f5c220: first release Low5/26/2025

Dependencies & License Audit

Loading dependencies...

Similar Packages

mcp-safe-runTired of hardcoding secrets like API keys in your MCP client configuration (e.g., mcp.json, claude_desktop_config.json)? mcp-secure-launcher lets you run your existing MCP servers securely without mod2.4.6
argus-mcp🔍 Enhance code quality with Argus MCP, an AI-driven code review server using a Zero-Trust model for safe and efficient development.main@2026-06-07
Create-MCP🚀 Generate and extend production-ready Model Context Protocol (MCP) servers with a modern CLI tool that showcases all MCP features in one cohesive example.main@2026-06-06
arxiv-mcp-serverarXiv MCP Server Client 🐙 enables AI assistants to search, retrieve, analyze, and summarize arXiv papers with features like author/category browsing, trends, and citation insights.main@2026-06-06
exa-mcp-serverExa MCP for web search and web crawling!main@2026-06-04

More in MCP Servers

PlanExeCreate a plan from a description in minutes
agentroveYour own Claude Code UI, sandbox, in-browser VS Code, terminal, multi-provider support (Anthropic, OpenAI, GitHub Copilot, OpenRouter), custom skills, and MCP servers.
ProxmoxMCP-PlusEnhanced Proxmox MCP server with advanced virtualization management and full OpenAPI integration.
node9-proxyThe Execution Security Layer for the Agentic Era. Providing deterministic "Sudo" governance and audit logs for autonomous AI agents.