列表-MCP

Name: 列表-MCP
Author: lirantal

作者：lirantal75 星标更新：2025-11-23

项目介绍

<p align="center"><h1 align="center"> ls-mcp </h1> <p align="center"> 在本地开发环境中检测已配置的MCP（模型上下文协议）服务器 </p> <p align="center"> <a href="https://www.npmjs.org/package/ls-mcp"><img src="https://badgen.net/npm/v/ls-mcp" alt="npm 版本"/></a> <a href="https://www.npmjs.org/package/ls-mcp"><img src="https://badgen.net/npm/license/ls-mcp" alt="许可证"/></a> <a href="https://www.npmjs.org/package/ls-mcp"><img src="https://badgen.net/npm/dt/ls-mcp" alt="下载量"/></a> <a href="https://github.com/lirantal/ls-mcp/actions?workflow=CI"><img src="https://github.com/lirantal/ls-mcp/workflows/CI/badge.svg" alt="构建"/></a> <a href="https://codecov.io/gh/lirantal/ls-mcp"><img src="https://badgen.net/codecov/c/github/lirantal/ls-mcp" alt="测试覆盖率"/></a> <a href="https://snyk.io/test/github/lirantal/ls-mcp"><img src="https://snyk.io/test/github/lirantal/ls-mcp/badge.svg" alt="已知漏洞"/></a> <a href="./SECURITY.md"><img src="https://img.shields.io/badge/安全-负责任披露黄色.svg" alt="负责任披露政策" /></a> </p> <div align="center"> <img src="https://github.com/lirantal/ls-mcp/blob/main/.github/ls-mcp-logo.png?raw=true" alt="ls-mcp 标识"/> </div>

功能

🔍 MCP 发现: 自动检测各种AI应用和代理IDE中的MCP服务器
📁 目录冒泡: 智能发现项目范围内的MCP配置文件，支持项目范围的MCP服务器配置和全局配置
🔄 进程检测: 实时监控运行中的MCP服务器状态
🔒 凭证分析: 对环境变量和API密钥进行安全分析，检查潜在暴露的凭证

使用方法：CLI

npx ls-mcp

分析特定文件

要分析特定的MCP配置文件而不是使用自动发现，可以使用--files标志。此标志替换自动发现，并仅分析您指定的文件：

# 单个文件
npx ls-mcp --files ./mcp-config.json

# 多个文件（逗号分隔）
npx ls-mcp --files ./config1.json,./config2.json

# 多个文件（空格分隔）
npx ls-mcp --files ./config1.json ./config2.json

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

servers - 标准MCP配置键
mcpServers - 替代MCP配置键
mcp.servers - 嵌套配置格式
context_servers - 上下文配置格式

显示所有提供者

默认情况下，ls-mcp隐藏没有配置服务器的提供者以减少混乱。要显示所有提供者，包括那些空配置的，可以使用--all或-a标志：

# 显示所有提供者，包括空配置的
npx ls-mcp --all

# 短形式
npx ls-mcp -a

# 结合JSON输出
npx ls-mcp --all --json

注意：当使用--files来分析特定配置文件时，即使自定义组中没有服务器，也会始终显示该组，因为您明确请求分析这些文件。

JSON 输出

要以JSON格式输出结果（适用于程序化消费）：

npx ls-mcp --json

# 结合--files标志
npx ls-mcp --files ./config.json --json

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

mcpFiles: 按提供者组织的完整MCP服务器配置（除非指定了--all，否则只包括有配置服务器的提供者）
summary: 统计信息，包括总服务器数、运行中的服务器数、凭证警告和传输分解

调试模式

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

# 启用ls-mcp的调试日志
NODE_DEBUG=ls-mcp npx ls-mcp

# 启用所有调试日志
NODE_DEBUG=* npx ls-mcp

文档

关于项目架构和特性的详细信息：

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