AI导哈

MCP检测工具

ls-mcp是一个用于检测本地开发环境中配置的MCP（模型上下文协议）的工具，支持自动发现、目录遍历、实时进程检测和安全凭证分析。

  • by lirantal
  • TypeScript
  • 本地部署
  • 84 星标
  • 更新于
在 GitHub 查看 lirantal/ls-mcp

使用说明

ls-mcp

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

特征

  • 🔍 MCP发现：自动检测各种AI应用程序和代理IDE中的MCP服务器
  • 📁 目录起泡：从嵌套目录中智能发现项目范围的MCP配置，支持项目范围的MCP-Server配置和全局配置
  • 🔄 过程检测：正在运行的MCP服务器的实时状态
  • 🔒 凭证分析：对MCP服务器中潜在暴露的凭据的环境变量和API密钥进行安全分析

用法：CLI

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 flag会自动检测文件中的配置结构，支持各种格式，包括：

  • 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

文档

有关项目架构和功能的详细信息：

文档

贡献

请咨询 贡献 了解为该项目做出贡献的指导方针。

作者

ls mcp © 塔尔里拉，根据 阿帕奇-2.0 许可证。

相关 MCP