MCP Server For Find Reference

🚀 MCP サーバー設定ガイド（参照検索用）

このガイドでは、MCP サーバーの設定方法や機能、テスト方法、将来的な機能計画について説明します。

🚀 クイックスタート

MCP サーバーの設定

1. http://localhost:3001 を使用して、サーバーを AMP に追加し、get-text-matches と名前を付けます。
2. サーバーを起動するには、node server.js コマンドを実行します。

✨ 主な機能

MCP サーバーは 2 種類のツールをサポートしています。これらのツールは、指定されたディレクトリ内のすべてのファイルを再帰的に走査します。

• get-text-matches ツール：正確なテキストマッチの位置を示す {file, line, column} のリストを返します。
• get-parse-tree ツール：指定された文字列の構文解析ツリーのメタデータを返します。

💻 使用例

サンプルディレクトリの作成

新しいディレクトリで以下のコマンドを実行して、サンプルのクライアントファイルを作成します。

mkdir client && cd client && echo -e "import { temp_x } from './scope.js';\n\ntemp_x = 5;\n\ntemp_x = 7 + 4;\n\nconsole.log(temp_x);" > include_scope.js && echo -e "let temp_x = 5;\n\ntemp_x = 7 + 4;\n\nconsole.log(temp_x);" > exclude_scope.js && echo -e "let temp_x = \"Hello\";\n\nif(true){\n    let temp_x = 10;\n    console.log(temp_x);\n}\n\ntemp_x = \"World\";\n\n{\n    temp_x;\n}" > scope.js

get-text-matches の使用

MCP サーバーに以下のコマンドを実行するよう指示します。

use the get-text-match tool to find temp_x, specify the full path

get-parse-tree の使用

MCP サーバーに以下のコマンドを実行するよう指示します。

use the get-parse-tree tool to find temp_x, specify the full path

これにより、以下のような追加の指示が可能になります。

what are the different node types of temp_x

または

what type of variable is temp_x

または

where is temp_x defined in include_scope
``` と ```where is temp_x defined in exclude_scope

これらの指示は、より複雑なクエリに組み合わせることができます。

what variable type is temp_x in the scope of include_scope

⚠️ 重要提示

クライアントは関連ファイルに直接アクセスできるため、現在は get-text-match と get-parse-tree ツールを使用するように指示する必要があります。

トラブルシューティング

MCP サーバーが誤ったツールを選択した場合、特定のツールを使用しないように指示することができます。例えば：

use the parse tree tool, not get text, to find temp_x, specify the full path

場合によっては、完全なパスを指定する必要はありませんが、時々サーバーが現在のディレクトリを . と判断することがあるため、明示的に指定することをお勧めします。

💡 使用建议

MCP サーバーは、クライアントがチェックするローカルディレクトリを信頼する必要があります。必要に応じて、パスをハードコードすることができます。

🔧 技術詳細

将来的な機能計画

1. 大文字と小文字を区別しないマッチングを実装する。
2. 特定のファイル/フォルダを無視できるようにする。例えば、node_modules を含むディレクトリで "import" を検索すると、トークン制限を超えることがあります。
3. より見やすく簡潔な構文解析ツリーの出力形式を提供する。