Cursormcpmonitor

🚀 カーソルMCPモニター

カーソルMCP（Machine Control Protocol）モニターは、MCPプロトコルのやり取りを監視および分析するためのツールです。開発者がMCPサーバーの実装をデバッグし、プロトコルメッセージやエラーパターンを分析し、クライアントのライフサイクルと接続状態を追跡するのに役立ちます。

🚀 クイックスタート

カーソルMCPモニターを使用することで、MCPプロトコルのやり取りを効果的に監視および分析できます。以下のセクションでは、インストール方法、機能特性、使用シーンなどについて説明します。

✨ 主な機能

• プロトコル監視：クライアントとサーバーのやり取り操作をリアルタイムで追跡します。
• ログ記録：構造化ログを自動生成し、分析や問題解決を容易にします。
• エラー処理：指数退避アルゴリズムを備え、一時的な障害から自動的に復旧します。
• ファイルポーリング：ファイルポーリングと截断検出をサポートします。
• パフォーマンス監視：詳細なパフォーマンス指標とエラー率統計を提供します。

📦 インストール

前提条件

• .NET 9.0開発ツールキット以上

NuGetを使用したインストール

dotnet add package CursorMCPMonitor --version 1.0.0

📚 ドキュメント

設定オプション

環境変数設定

以下の環境変数を使用して、グローバルな設定を行うことができます。

• CURSOR_LOGS_ROOT：ログのルートディレクトリを設定します。デフォルトは./logsです。
• CURSOR_POLL_INTERVAL：ポーリング間隔（ミリ秒）を設定します。デフォルトは1000です。
• CURSOR_LOG_PATTERN：ログファイルのマッチングパターンを設定します。デフォルトはCursorMCP*.logです。

設定ファイルの例

[Global]
LogsRoot = ./logs
PollInterval = 1000
LogPattern = CursorMCP*.log

[Console]
Verbosity = info
ColorEnabled = true

[File]
EnableRotation = true
MaxFileSize = 1MB

使用シーン

• MCPサーバーの実装をデバッグする。
• プロトコルメッセージとエラーパターンを分析する。
• サーバーの能力とサービス提供状況を監視する。
• プロトコルの実装の正しさを検証する。
• 構造化ログを通じてアプリケーションのパフォーマンスを分析する。

ログ記録と可観測性

構造化ログ形式

コンソール出力の例：

[2025-03-03 12:34:56.789] [INF] [CursorMCPMonitor.Services.LogProcessorService] CreateClient detected: Cursor MCP.log 2025-03-03 12:34:56.123 [info] a602: 処理CreateClient操作

ファイル出力の例：

2025-03-03 12:34:56.789 +00:00 [INF] [CursorMCPMonitor.Services.LogProcessorService] CreateClient detected: Cursor MCP.log 2025-03-03 12:34:56.123 [info] a602: 処理CreateClient操作

ログレベルの説明

• debug：デバッグ情報。内部状態を詳細に出力します。
• info：一般情報。正常な操作を記録します。
• warning：警告情報。潜在的な問題を示します。
• error：エラー情報。機能異常を記録します。
• critical：重大なエラー。システムのクラッシュを引き起こす可能性があります。

エラー処理メカニズム

一般的なエラーと解決策

Dockerデプロイガイド

イメージのビルド

FROM mcr.microsoft.com/dotnet/runtime:7.0.0-alpine AS base
WORKDIR /app
COPY . .

ENTRYPOINT ["dotnet", "run"]

コンテナの起動

docker build -t cursor-mcp-monitor .
docker run --name cursor-mcp-monitor -p 5000:5000 cursor-mcp-monitor

📄 ライセンス

このプロジェクトはMITオープンソースライセンスに準拠しており、コードとドキュメントは自由に使用、変更、配布することができます。

詳細なヘルプが必要な場合は、公式ドキュメントを参照するか、サポートチームにお問い合わせください。