MCP Diagnostics Trae

🚀 MCP Diagnostics - Trae IDE 診断情報読み取りツール

Trae IDE 用に開発された MCP (Model Context Protocol) サーバーです。Trae の AI Agent がリアルタイムでプロジェクト内のエラー、警告、ヒント情報を取得できるようにし、より高度なコード分析と提案を提供します。

英語ドキュメント: README_EN.md

🚀 クイックスタート

ステップ 1: VS Code 拡張機能のインストール

このツールが VS Code の診断情報にアクセスできるようにするには、まず対応する VS Code 拡張機能をインストールする必要があります。

1. VS Code を開きます。
2. コマンドパネル (Ctrl+Shift+P または Cmd+Shift+P) を開きます。
3. “拡張: 从 VSIX 安装...” を選択します。
4. このプロジェクトの diagnostics-extension ディレクトリ内の trae-diagnostics-server-0.0.1.vsix ファイルを見つけてインストールします。
5. インストール後、VS Code ウィンドウを再読み込みします。

インストールが成功すると、拡張機能は自動的に診断データを提供するためのローカルサーバーをバックグラウンドで起動します。

ステップ 2: プロジェクトのクローンとビルド

# プロジェクトをクローンする
git clone https://github.com/lin037/mcp-diagnostics-trae.git
cd mcp-diagnostics

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

ステップ 3: Trae での設定

1. Trae の MCP 設定を開きます。
2. 手動追加 を選択します。
3. 以下の設定を貼り付けます。

{
  "mcpServers": {
    "diagnostics": {
      "command": "npx",
      "args": ["-y", "/path/to/mcp-diagnostics"],
      "description": "Trae IDE 診断情報読み取りツール"
    }
  }
}

注意: args 内の /path/to/mcp-diagnostics を、クローンしたプロジェクトの実際のパスに置き換えてください。

例えば、git clone 後にプロジェクトが E:/MCPWork/trae-diagnostics/mcp ディレクトリにある場合:

{
  "mcpServers": {
    "diagnostics": {
      "command": "npx",
      "args": [
        "-y",
        "E:/MCPWork/trae-diagnostics/mcp"
      ]
    }
  }
}

✨ 主な機能

• 🔍 リアルタイム診断: Trae IDE の現在の作業ディレクトリ内のすべての診断情報（エラー/警告/ヒント）を読み取ります。
• 📁 ファイルレベルの診断: 指定されたファイルの診断情報を取得し、さまざまなパス形式をサポートします。
• 📊 統計要約: 診断の統計情報（ファイル数、エラー数、警告数）をすぐに確認できます。
• 🤖 AI 強化: Trae の AI Agent がコードの問題を理解し、より正確な修正提案を提供できるようにします。
• 🔌 拡張機能との連携: 対応する VS Code 拡張機能を通じて、安定して効率的に診断情報を取得します。
• 🎯 スマートマッチング: 相対パス、ファイル名、絶対 URI など、さまざまなファイルパス形式をサポートします。

🎯 プロジェクトの目標

このプロジェクトは Trae IDE 用に特別に設計されており、Trae の AI Agent が以下のことを行えるようにすることを目的としています。

• コード内のエラーと警告をリアルタイムで把握する
• 実際の問題に基づいた修正提案を提供する
• プロジェクトのコード品質をスマートに分析する
• 開発者が問題を迅速に特定して解決できるように支援する

📚 ドキュメント

🛠️ MCP ツール一覧

1. getDiagnostics()

現在の作業ディレクトリ内のすべてのファイルの診断情報を取得します。

入力: パラメータなし

{}

出力: 診断情報の配列

[
  {
    "uri": "file:///workspace/src/index.ts",
    "diagnostics": [
      {
        "range": {
          "start": { "line": 12, "character": 5 },
          "end": { "line": 12, "character": 10 }
        },
        "severity": 1,
        "source": "typescript",
        "message": "类型 'string' 不能赋值给类型 'number'。"
      }
    ]
  }
]

2. getDiagnosticsForPath(filePath) ⭐ おすすめ

ファイルパスに基づいて診断情報を取得し、柔軟なパスマッチングをサポートします。

入力:

{
  "filePath": "src/index.ts"
}

サポートされるパス形式:

• 相対パス：src/index.ts
• ファイル名：index.ts
• ディレクトリ付きのファイル名：test/TestJava.java

出力: 一致するファイルの診断情報の配列

使用例:

• TypeScript ファイルを確認する: "filePath": "src/index.ts"
• Java ファイルを確認する: "filePath": "TestJava.java"
• テストファイルを確認する: "filePath": "test/test-errors.ts"

3. getDiagnosticsForFile(fileUri)

指定されたファイルの診断情報を取得します（完全な URI が必要です）。

入力:

{
  "fileUri": "file:///workspace/src/index.ts"
}

注意: file:///workspace/ で始まる完全な URI 形式を使用する必要があります。

4. getDiagnosticsSummary()

診断の統計情報を取得します。

入力: パラメータなし

{}

出力: 統計要約

{
  "totalFiles": 4,
  "errors": 4,
  "warnings": 4
}

💬 使用例

プロジェクトの診断要約を取得する

ユーザー: "現在のプロジェクトの診断要約を確認してください"

AI は自動的に getDiagnosticsSummary ツールを呼び出します。

すべての診断詳細を取得する

ユーザー: "現在のプロジェクトのすべてのエラーと警告をリストアップしてください"

AI は getDiagnostics ツールを呼び出します。

特定のファイルの診断を取得する

ユーザー: "src/index.ts ファイルの問題を確認してください"

AI は getDiagnosticsForPath ツールを呼び出し、パラメータは {"filePath": "src/index.ts"} となります。

サポートされる会話例

• "現在のプロジェクトにはいくつのエラーがありますか？"
• "すべての TypeScript 型エラーを見つけてください"
• "すべての警告情報をリストアップしてください"
• "TestJava.java ファイルに何か問題があるか確認してください"
• "プロジェクトのコード品質はどうですか？"
• "修正が必要なファイルはどれですか？"

📊 診断の深刻度レベル

• 1 - エラー (Error) ❌
• 2 - 警告 (Warning) ⚠️
• 3 - 情報 (Info) ℹ️
• 4 - ヒント (Hint) 💡

🔧 技術詳細

Trae IDE (MCPクライアント) ←→ MCPサーバー ←→ Trae IDE (DAPインターフェース)

1. MCP 層: @modelcontextprotocol/sdk を使用して標準 MCP プロトコルを実装します。
2. 通信層: stdin/stdout を通じて Trae と通信します。
3. 診断層: Debug Adapter Protocol を通じて Trae IDE に接続します。
4. データ層: 診断情報を解析してフォーマットします。

🛠️ 開発

開発モードで実行する

npm run dev

ビルドする

npm run build

接続をテストする

# サーバーを起動する
npm start

# 別のターミナルでテストする
node test-file-diagnostics.js

❓ トラブルシューティング

Trae IDE に接続できない場合

解決策:

1. Trae IDE が実行中であることを確認してください。
2. プロジェクトが Trae で開かれていることを確認してください。
3. 言語サーバーの初期化が完了するのを待ってください。

空の診断情報が返される場合

考えられる原因:

1. プロジェクトにエラーや警告がない
2. 言語サーバーがまだ分析中
3. ファイルタイプが診断をサポートしていない

解決策:

• 数秒待ってから再試行してください。
• ファイルが保存されていることを確認してください。
• Trae が診断情報を表示していることを確認してください。

getDiagnosticsForFile が空の配列を返す場合

解決策:

• getDiagnosticsForPath ツールを使用する（おすすめ）
• 正しい URI 形式 file:///workspace/ファイルパス を使用することを確認する
• まず getDiagnostics を呼び出して、利用可能なファイル URI を確認する

ツールの呼び出しが失敗する場合

プロジェクトを確認する:

1. MCP サーバーが正常に起動していること
2. ネットワーク接続が正常であること
3. Trae のエラーログを確認する

🔮 将来展望

• 公式バージョン: Trae 公式が将来的に公式バージョンの MCP 診断ツールを開発する可能性があると考えられます。
• コミュニティによるメンテナンス: このプロジェクトは完全に作者が AI を通じて開発したもので、技術的な制限があるため、将来のメンテナンスは主にコミュニティの fork に依存します。
• 現在の状態: 現在のバージョンは機能が完全で、日常の使用に十分です。

🤝 貢献とメンテナンス

このプロジェクトは作者が AI アシスタントを通じて開発したものです。作者の技術的な制限と時間的な制約により、将来のメンテナンスは主にコミュニティに依存します。

• Fork 歓迎: 他の開発者がこのプロジェクトを fork して改良することを歓迎します。
• Issue の報告: Issue を提出することができますが、応答が遅れる場合があります。
• Pull Request: PR の提出を歓迎し、できる限りレビューします。
• コミュニティ主導: コミュニティが自発的にメンテナンスと改良を行うことを奨励します。

📄 ライセンス

このプロジェクトは MIT ライセンス の下で提供されています。

🎉 これで Trae の AI Agent がプロジェクト内のコードの問題をリアルタイムで把握できるようになりました！