MCP 分析中间件

一种简单的方式，用于跟踪和可视化您的 MCP 服务器的使用情况。了解哪些工具最受欢迎，尽早发现错误，并掌握服务器性能。

• 支持博客文章

功能

• 🔍 跟踪所有工具调用和资源请求
• 📊 查看性能指标和错误率
• 🌐 带有实时分析的网络仪表盘
• 💾 使用 SQLite 数据库实现持久化存储

快速开始

1. 安装包：

yarn add mcp-analytics-middleware

2. 添加到您的 MCP 服务器中：

import { McpAnalytics } from 'mcp-analytics-middleware';

let server = new McpServer({ 
name: 'Sample MCP Server with Analytics',
version: '1.0.0'
});

const analytics = new McpAnalytics('analytics.db');

server = analytics.enhance(server); // 覆盖工具和资源函数实现以记录使用情况到 sqlite

实时分析

想要为一个 TypeScript SDK MCP 服务器（使用此中间件）直接提供实时仪表盘？可以使用以下命令：

npx -p mcp-analytics-middleware web-viewer --db-path analytics.db

该网络仪表盘将在 http://localhost:8080 打开，并显示实时分析！

您将看到：

• 总工具调用和资源请求数量
• 错误率和性能指标
• 最常用的工具和最慢的操作

示例实现

可以找到以下示例实现。

1. 带有分析中间件的 Dummy Calculator Server 示例 src/server.ts
2. 带有分析中间件的 Ethereum RPC MCP 服务器 server/index.ts_
3. 加入了分析中间件的 Google Maps MCP 服务器版本 src/google-maps/index.ts

使用 Inspector 运行

如果您正在使用 MCP Inspector，只需添加分析标志：

yarn inspector --analytics --db-path analytics.db

许可证

MIT