用于查找引用的 MCP 服务器

配置 MCP 服务器

1. 使用 http://localhost:3001 将服务器添加到 AMP，并将其命名为 get-text-matches。
2. 使用 node server.js 运行服务器。

当前功能

MCP 服务器支持两个工具。这两个工具都将递归地运行在给定目录中的所有文件上。

get-text-matches 工具返回一个 {file, line, column} 列表，其中包含找到的精确文本匹配项。

get-parse-tree 工具返回给定字符串的解析树的元数据。

测试 MCP 服务器

示例目录

要开始使用，请在新目录中运行以下命令以创建一个示例客户端文件：

<pre>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</pre>

get-text-matches

使用以下命令提示 MCP 服务器：

use the get-text-match tool to find temp_x, specify the full path (使用 get-text-match 工具查找 temp_x，指定完整路径)

get-parse-tree

使用以下命令提示 MCP 服务器：

use the get-parse-tree tool to find temp_x, specify the full path (使用 get-parse-tree 工具查找 temp_x，指定完整路径)

这允许后续提示，例如：

what are the different node types of temp_x (temp_x 的不同节点类型是什么)

或者

what type of variable is temp_x (temp_x 是什么类型的变量)

或者

where is temp_x defined in include_scope (temp_x 在 include_scope 中定义在哪里) 和 where is temp_x defined in exclude_scope (temp_x 在 exclude_scope 中定义在哪里)

这些提示可以组合成更复杂的内容，例如 what variable type is temp_x in the scope of include_scope (在 include_scope 的作用域中，temp_x 的变量类型是什么)

注意：客户端会尝试自己查找此信息，因为它可以直接访问相关文件，因此目前需要告诉它使用 get-text-match 和 get-parse-tree 工具。

故障排除

如果 MCP 服务器选择了错误的工具，您可以告诉它明确不要使用某个工具。 例如：

use the parse tree tool, not get text, to find temp_x, specify the full path (使用解析树工具，而不是 get text，来查找 temp_x，指定完整路径)

并不总是需要告诉它指定完整路径，但偶尔它会决定使用 . 作为目录而不是完整路径，而服务器需要完整路径。

MCP 服务器必须信任客户端告诉它要检查的本地目录。 如果需要，您可以硬编码路径。

未来的功能

1. 返回不区分大小写的匹配项。
2. 允许忽略的文件/文件夹。 例如，在包含 node_modules 的目录中搜索 "import" 会超出令牌限制。
3. 为解析树制作更漂亮、更简洁的输出。