MCP Server Lister

v1.0.0Developer Toolsstable

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

claude-aiclaude-desktopcursorcursor-aimcp
Share:
83
Stars
0
Downloads
0
Weekly
0/5

What is MCP Server Lister?

MCP Server Lister is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to list mcp server configurations in your system used by ai applications like cursor, claude desktop, vs code and others

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

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • List MCP Server configurations in your system used by AI app

Use Cases

List MCP server configurations across your system.
Discover MCP servers in Cursor, Claude Desktop, and VS Code.
Audit configured MCP servers and their settings.
lirantal

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx ls

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Server Lister

ls-mcp is a CLI tool and MCP server that automatically discovers and lists all MCP server configurations across the AI applications installed on your system, including Claude Desktop, Cursor, VS Code, and other agentic IDEs. It traverses both global and project-scoped configuration files, detects which MCP servers are currently running as processes, and performs security analysis to flag potentially exposed API keys or credentials in environment variables. It supports multiple MCP configuration key formats so it works regardless of which AI tool generated the config.

Prerequisites

  • Node.js 18 or higher installed
  • At least one AI application with MCP server configurations (Claude Desktop, Cursor, VS Code, etc.)
  • An MCP-compatible client if using ls-mcp as a server rather than a CLI tool
  • npx available (bundled with Node.js)
1

Run ls-mcp directly with npx

The fastest way to use ls-mcp is via npx — no installation required. Running the command scans your system for all known MCP configuration locations and prints a summary.

npx ls-mcp
2

Scan specific configuration files

You can point ls-mcp at specific JSON config files rather than relying on auto-discovery, which is useful for CI or auditing a particular project.

npx ls-mcp --files ./mcp-config.json ~/.cursor/mcp.json
3

Include providers with no configured servers

By default, providers with zero MCP servers are hidden. Use --all to show every detected provider even if it has no configured servers.

npx ls-mcp --all
4

Output JSON for programmatic use

Use --json to get machine-readable output including server details, running process status, transport types, and credential warnings.

npx ls-mcp --json
5

Configure as an MCP server in Claude Desktop

To use ls-mcp as an MCP tool (so Claude can query your MCP configuration), add it to your claude_desktop_config.json.

{
  "mcpServers": {
    "ls-mcp": {
      "command": "npx",
      "args": ["-y", "ls-mcp"]
    }
  }
}

MCP Server Lister Examples

Client configuration

Add ls-mcp as an MCP server so Claude or another AI assistant can introspect your MCP setup on demand.

{
  "mcpServers": {
    "ls-mcp": {
      "command": "npx",
      "args": ["-y", "ls-mcp"]
    }
  }
}

Prompts to try

Use ls-mcp through Claude to audit and explore your MCP server setup.

- "List all MCP servers configured on my system"
- "Which MCP servers are currently running?"
- "Are there any API keys exposed in my MCP server configurations?"
- "Show me the MCP servers configured for Cursor"
- "Audit my MCP configurations and flag any credential warnings"

Troubleshooting MCP Server Lister

No MCP servers are detected even though they are configured

Run with `NODE_DEBUG=ls-mcp npx ls-mcp` to enable verbose logging and see which paths are being scanned. Also try `npx ls-mcp --all` to include providers with empty configs. The tool looks for standard config file locations; if yours is non-standard, use `--files` to specify it directly.

Credential warnings appear for API keys in environment variables

ls-mcp flags environment variable values that look like secrets for security awareness. Review the flagged servers and consider using a secrets manager or referencing variables by name rather than embedding plaintext values in config files.

JSON output is missing some providers

By default only providers with at least one server are included. Add `--all` to the command to include all detected providers regardless of whether they have servers configured.

Frequently Asked Questions about MCP Server Lister

What is MCP Server Lister?

MCP Server Lister is a Model Context Protocol (MCP) server that list mcp server configurations in your system used by ai applications like cursor, claude desktop, vs code and others It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Server Lister?

Follow the installation instructions on the MCP Server Lister GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Server Lister?

MCP Server Lister works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Server Lister free to use?

Yes, MCP Server Lister is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "ls": { "command": "npx", "args": ["-y", "ls"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Server Lister?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides