lirantal/ls-mcp

View on GitHub ↗

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

84 ★8 forksTypeScriptUpdated 18d ago

What you need to know

CLI utility that detects and analyzes configured MCP servers in your local dev environment across AI apps and IDEs, including project-scoped config discovery and credential analysis.

Install

npx ls-mcp

Usage

  • •npx ls-mcp
  • •npx ls-mcp --files ./mcp-config.json
  • •npx ls-mcp --all --json
  • •NODE_DEBUG=ls-mcp npx ls-mcp

Key features

  • ✓MCP discovery across various AI applications and agentic IDEs
  • ✓Directory bubbling for project-scoped and global MCP configs
  • ✓Real-time status of running MCP servers (process detection)
  • ✓Credential analysis flags potentially exposed secrets in MCP server configs
  • ✓--files flag analyzes specific configs with auto-detected key structures (servers, mcpServers, mcp.servers, context_servers)
  • ✓JSON output for programmatic consumption

Best for

Developers who want to inventory, inspect, and security-audit which MCP servers are configured across their local tooling

Caveats

  • ⚠This is a discovery/analysis CLI, not an MCP server that exposes tools
  • ⚠Providers with zero configured servers are hidden unless --all is passed
  • ⚠The --files flag replaces automatic discovery
Platforms: macOS · Linux · Windows
Documentation ↗

Reviewed 2026-08-11

Topics

claude-aiclaude-desktopcursorcursor-aimcpmcp-servermodel-context-protocol
Stars
84★
Forks
8
Language
TypeScript
License
Apache-2.0
Created
2025-05-26
Last push
2026-08-17