ls-mcp

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

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

JSON Output

To output results in JSON format (useful for programmatic consumption):

npx ls-mcp --json

This will return a structured JSON object containing:

• mcpFiles: Complete MCP server configurations organized by provider (only includes providers with configured servers)
• 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:

• Project Overview: Comprehensive project analysis and architecture
• Design Documentation: Technical design decisions and implementation details
• Requirements: Functional and non-functional requirements
• Directory Bubbling: Intelligent directory traversal feature
• URL Hostname Extraction: Clean display of hostnames for URL-based servers
• Credential Detection: Security analysis features

Author

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