MCP 报告工具

MCP 报告工具是一款用于生成关于模型上下文协议（MCP）服务器功能的全面报告的实用工具，帮助开发者了解其 MCP 服务器生态系统的可用功能。也可以程序化地使用它来为文档生成报告或将其集成到其他工具中。

目录

• 功能
• 安装
• 配置
• 用法
• 报告结构
• 项目结构
• 示例报告
• 开发
• 许可证
• 作者

功能

• 服务器发现：自动连接到所有启用的 MCP 服务器
• 功能分析：提取工具、资源和资源模板
• Markdown 报告生成：生成结构清晰的文档
• 进度监控：提供实时执行反馈

生成报告示例图（部分）

安装

先决条件

• Node.js 16.x 或更高版本
• npm 或 yarn

从源代码安装

# 克隆仓库
git clone https://github.com/cyanheads/mcp-reporter.git
cd mcp-reporter

# 安装依赖项
npm install

# 构建项目
npm run build

# 创建符号链接（可选）
npm link

配置

MCP 报告工具需要一个配置文件，该文件定义了要分析的 MCP 服务器：

# 从示例创建配置文件
cp mcp-servers.json.example mcp-servers.json

使用方法

命令行选项

以下是 MCP 报告工具支持的主要命令行选项：

示例代码

命令行界面（CLI）

// cli.ts
import { program } from 'commander';

program
  .version('1.0.1')
  .description('MCP Reporter CLI工具')
  .option('--config <类型>', '指定配置文件路径', parseConfig)
  .action((options: IOptions) => {
    // 处理逻辑
  });

program.parse(process.argv);

主程序

// index.ts
export interface IReporterConfig {
  servers: string[];
  output?: string;
}

export class Reporter {
  private config: IReporterConfig;

  constructor(config: IReporterConfig) {
    this.config = config;
  }

  public generateReport(): void {
    // 生成报告的逻辑
  }
}

报告结构

// 示例报告结构
interface ReportStructure {
  servers: ServerInfo[];
  summary?: Summary;
}

interface ServerInfo {
  name: string;
  version: string;
  features: Feature[];
}

enum Feature {
  ContextService = 'context_service',
  ModelManager = 'model_manager'
}

项目结构

mcp-reporter/
├── src/               # 源代码
│   ├── cli.ts         # 命令行接口
│   ├── index.ts       # 主程序代码
│   ├── types/         # TypeScript 类型定义
│   └── utils/         # 工具函数
├── scripts/           # 构建和维护脚本
├── docs/              # 文档
├── output/            # 默认报告输出目录
└── mcp-servers.json   # 服务器配置文件（从示例创建）

开发

# 清理构建 artifacts
npm run clean

# 重建项目
npm run rebuild

# 生成项目结构可视化
npm run tree

许可证

本项目在 Apache 2.0 许可证下发布 - 有关详细信息，请参阅 LICENSE 文件。

作者

Casey Hand (@cyanheads)