返回 MCP 目录
public公开dns本地运行

mcp-analytics-middleware

MCP Analytics Middleware 是一个用于跟踪和可视化 MCP 服务器使用情况的工具,提供性能监控、错误追踪和实时数据分析功能。

article

README

🚀 MCP 分析中间件

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

npm 版本 npm 下载量

🚀 快速开始

安装包

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 打开,并显示实时分析!

您将看到:

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

示例实现

可以找到以下示例实现:

  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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端