ts-morph MCP工具

デバッグ用ラッパーの使用

開発中に MCP サーバーの起動シーケンスや標準入出力、エラー出力を詳細に確認したい場合、プロジェクトの scripts ディレクトリに配置されている mcp_launcher.js を使用できます。

このラッパースクリプトは、本来の MCP サーバープロセス (npx -y @sirosuzume/mcp-tsmorph-refactor) を子プロセスとして起動し、その起動情報や出力をプロジェクトルートの .logs/mcp_launcher.log ファイルに記録します。

使用方法:

1. mcp.json ファイルで、mcp-tsmorph-refactor サーバーの設定を以下のように変更します。 command を "node" にします。 args に、scripts/mcp_launcher.js へのパス (例: ["path/to/your_project_root/scripts/mcp_launcher.js"]) を指定します。プロジェクトルートからの相対パス (["scripts/mcp_launcher.js"]) も使用できます。

設定例 (mcp.json):

    {
      "mcpServers": {
        "mcp-tsmorph-refactor": {
          "command": "node",
          // scripts/mcp_launcher.js へのパス (プロジェクトルートからの相対パス or 絶対パス)
          "args": ["path/to/your_project_root/scripts/mcp_launcher.js"],
          "env": {
            // 元の環境変数設定はそのまま活かせます
            // 例:
            // "LOG_LEVEL": "trace",
            // "LOG_OUTPUT": "file",
            // "LOG_FILE_PATH": ".logs/mcp-ts-morph.log"
          }
        }
        // ... 他のサーバー設定 ...
      }
    }
    

1. MCP クライアント (例: Cursor) を再起動またはリロードします。

3. プロジェクトルートの .logs/mcp_launcher.log にログが出力されるのを確認してください。 また、MCP サーバー自体のログも、設定されていれば (例: .logs/mcp-ts-morph.log) 確認できます。

このラッパーを使用することで、MCP サーバーが期待通りに起動しない場合の原因究明に役立ちます。

参照箇所の検索 (`find_references_by_tsmorph`)

• 機能: 指定されたファイル内の特定の位置にあるシンボルの定義箇所と、プロジェクト全体でのすべての参照箇所を検索して一覧表示します。
• ユースケース: ある関数や変数がどこで使われているかを把握したい場合。リファクタリングの影響範囲を調査したい場合。
• 必要な情報: プロジェクトの tsconfig.json パス、対象ファイルのパス、シンボルの位置 (行・列)。

公開方法

リリースワークフローをトリガーするには、Git タグのプッシュを使用します。

方法: Git タグのプッシュ (リリース時に推奨)

• 想定される用途: 通常のバージョンリリース（メジャー、マイナー、パッチ）。Git の履歴とバージョンが明確に対応するため、標準的なリリースプロセスとして推奨されます。

1. バージョン更新: package.json の version を変更します (例: 0.3.0)。 2. コミット & プッシュ: package.json の変更をコミットし、main ブランチにプッシュします。 3. タグ作成 & プッシュ: バージョンに一致する Git タグ (v プレフィックス付き) を作成し、プッシュします。

    git tag v0.3.0
    git push origin v0.3.0