ls-mcp

ls-mcp

检测本地开发环境中已配置的 MCP（Model Context Protocol）

功能

• 🔍 MCP 发现：自动检测各种 AI 应用和 Agentic IDE 中的 MCP 服务
• 📁 目录冒泡：从嵌套目录中智能发现项目范围的 MCP 配置，支持项目范围的 MCP 服务配置和全局配置
• 🔄 进程检测：实时查看正在运行的 MCP 服务状态
• 🔒 凭据分析：分析环境变量和 API 密钥的安全性，检测 MCP 服务中可能暴露的凭据

用法：命令行界面

npx ls-mcp

分析指定文件

如需分析指定的 MCP 配置文件，而不是使用自动发现，请使用 --files 标志。此标志会替代自动发现功能，只分析你指定的文件：

# 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

--files 标志会自动检测文件中的配置结构，支持多种格式，包括：

• servers - 标准 MCP 配置键
• mcpServers - 另一种 MCP 配置键
• mcp.servers - 嵌套配置格式
• context_servers - 基于上下文的配置格式

显示所有提供程序

默认情况下，ls-mcp 会隐藏没有配置任何服务的提供程序，以减少杂乱。若要显示所有提供程序，包括配置为空的提供程序，请使用 --all 或 -a 标志：

# 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

注意：使用 --files 分析指定的配置文件时，即使自定义组中没有任何服务，也始终会显示该组，因为你已明确要求分析这些文件。

JSON 输出

如需以 JSON 格式输出结果（便于程序处理）：

npx ls-mcp --json

# Combine with --files flag
npx ls-mcp --files ./config.json --json

这将返回一个结构化的 JSON 对象，其中包含：

• mcpFiles：按提供程序整理的完整 MCP 服务配置（除非指定 --all，否则仅包含已配置服务的提供程序）
• summary：统计信息，包括服务总数、正在运行的服务数、凭据警告和传输方式明细

调试模式

如需启用详细的调试输出，请设置 NODE_DEBUG 环境变量：

# Enable debug logging for ls-mcp
NODE_DEBUG=ls-mcp npx ls-mcp

# Enable all debug logging
NODE_DEBUG=* npx ls-mcp

文档

如需了解项目架构和功能的详细信息：

• 项目概览：全面的项目分析和架构说明
• 设计文档：技术设计决策和实现细节
• 需求：功能性和非功能性需求
• 自定义文件分析：使用 --files 标志分析指定的 MCP 配置文件
• 目录冒泡：智能目录遍历功能
• URL 主机名提取：清晰显示基于 URL 的服务的主机名
• 凭据检测：安全分析功能

文档

• 项目文档 - 开发、测试、架构和规范。

参与贡献

请参阅 CONTRIBUTING，了解为此项目贡献的指南。

作者

ls-mcp © Liran Tal，基于 Apache-2.0 许可证发布。