MCP Analytics Middleware について
MCP Analytics Middleware は、MCP サーバーを監視する TypeScript ミドルウェアです。ツールやリソースの利用状況、性能、エラーを記録し、Web ダッシュボードで表示して SQLite に保存します。
主な機能
- 01ツール呼び出しとリソースリクエストの追跡
- 02性能とエラー率の測定
- 03Web ダッシュボードでのリアルタイム分析
- 04SQLite へのデータ保存
活用シーン
- 01利用頻度の高いツールの把握
- 02サーバーエラーの検出
- 03処理に時間のかかる操作の確認
- 04サーバーの稼働状況の監視
MCP 対応
TypeScript MCP SDK サーバーに組み込み、ツール呼び出しやリソースリクエストの分析データを収集します。Web ビューアーで保存した指標を表示できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP Analytics Middleware
MCP サーバーの利用状況を追跡して可視化する簡単な方法です。人気のあるツールを確認し、エラーを早期に検出して、サーバーのパフォーマンスを把握できます。
機能
- 🔍 すべてのツール呼び出しとリソースリクエストを追跡
- 📊 パフォーマンス指標とエラー率を確認
- 🌐 リアルタイム分析に対応したウェブダッシュボード
- 💾 永続ストレージ用のSQLiteデータベース
クイックスタート
- パッケージをインストールします:
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); // override tool and resource function implementation to record usage in sqlite
リアルタイム分析
このミドルウェアを使用するTyescript SDK MCP Serverのダッシュボードを確認したいですか?次の方法で、ライブダッシュボードを直接表示できます。
npx -p mcp-analytics-middleware web-viewer --db-path analytics.db
ウェブダッシュボードが http://localhost:8080 で開き、リアルタイム分析が表示されます!
次の情報を確認できます:
- ツール呼び出しとリソースリクエストの合計数
- エラー率とパフォーマンス指標
- 最も使用されているツールと、最も処理の遅い操作
実装例
分析ミドルウェアの実装例はこちらで確認できます。
- ダミー計算機サーバーの例 src/server.ts
- 分析機能を備えたEthereum RPC MCP Server server/index.ts_
- 分析ミドルウェアを追加したGoogle Maps MCP Serverのフォーク版 src/google-maps/index.ts
Inspectorでの実行
MCP Inspectorを使用している場合は、分析フラグを追加するだけです:
yarn inspector --analytics --db-path analytics.db
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。