article
README
🚀 MCP 分析中间件
一种简单的方式,用于跟踪和可视化您的 MCP 服务器的使用情况。通过它,您可以了解哪些工具最受欢迎,尽早发现错误,并掌握服务器性能。
🚀 快速开始
安装包
yarn add mcp-analytics-middleware
添加到您的 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
✨ 主要特性
- 🔍 跟踪所有工具调用和资源请求
- 📊 查看性能指标和错误率
- 🌐 带有实时分析的网络仪表盘
- 💾 使用 SQLite 数据库实现持久化存储
💻 使用示例
实时分析
想要为一个 TypeScript SDK MCP 服务器(使用此中间件)直接提供实时仪表盘?可以使用以下命令:
npx -p mcp-analytics-middleware web-viewer --db-path analytics.db
该网络仪表盘将在 http://localhost:8080 打开,并显示实时分析!
您将看到:
- 总工具调用和资源请求数量
- 错误率和性能指标
- 最常用的工具和最慢的操作
示例实现
可以找到以下示例实现:
- 带有分析中间件的 Dummy Calculator Server 示例 src/server.ts
- 带有分析中间件的 Ethereum RPC MCP 服务器 server/index.ts
- 加入了分析中间件的 Google Maps MCP 服务器版本 src/google-maps/index.ts
使用 Inspector 运行
如果您正在使用 MCP Inspector,只需添加分析标志:
yarn inspector --analytics --db-path analytics.db
📄 许可证
MIT
微信扫一扫