🚀 MCP 报告工具

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

🚀 快速开始

MCP 报告工具借助命令行选项，可轻松实现报告生成。你可以通过指定配置文件路径，快速启动报告生成流程。

// 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);

✨ 主要特性

• 服务器发现：自动连接到所有启用的 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 报告工具支持的主要命令行选项：

基础用法

命令行界面（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)