Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client