MCP Analytics Middleware

🚀 MCP 分析中间件

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に記録

✨ 主な機能

• 🔍 すべてのツール呼び出しとリソース要求を追跡
• 📊 パフォーマンス指標とエラー率を確認
• 🌐 リアルタイム分析付きのWebダッシュボード
• 💾 SQLiteデータベースを使用した永続的なストレージ

💻 使用例

基本的な使用法

yarn add mcp-analytics-middleware

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に記録

高度な使用法

リアルタイム分析のためのWebビューアの起動

TypeScript SDK MCPサーバー（このミドルウェアを使用）に直接リアルタイムダッシュボードを提供するには、以下のコマンドを使用します。

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

このWebダッシュボードは、http://localhost:8080 で開き、リアルタイム分析を表示します。

• 総ツール呼び出しとリソース要求数
• エラー率とパフォーマンス指標
• 最も頻繁に使用されるツールと最も遅い操作

Inspectorを使用した実行

MCP Inspectorを使用している場合は、分析フラグを追加するだけです。

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

サンプル実装

以下のサンプル実装を見つけることができます。

1. 分析ミドルウェア付きのダミーカルキュレータサーバーの例 src/server.ts
2. 分析ミドルウェア付きのEthereum RPC MCPサーバー server/index.ts
3. 分析ミドルウェアを追加したGoogle Maps MCPサーバーのバージョン src/google-maps/index.ts

📄 ライセンス

MIT