getDiagnosticsForPath

Retrieve diagnostic information for a specific file path, supporting flexible path formats including relative paths and filenames to identify code issues.

Instructions

🌟 推荐工具：根据文件路径获取诊断信息，支持灵活的路径匹配。可以使用相对路径、文件名等多种格式，比 getDiagnosticsForFile 更易用。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`filePath`	Yes	文件路径，支持多种格式： - 相对路径：src/index.ts - 文件名：index.ts - 带目录的文件名：test/TestJava.java 示例：要查看 index.ts 文件的问题，使用 "src/index.ts" 或 "index.ts"

Implementation Reference

src/vscode.ts:116-154 (handler)

Core handler implementing the getDiagnosticsForPath tool logic: fetches all diagnostics and applies flexible path matching (exact, suffix, filename, contains) to filter relevant file diagnostics.

async getDiagnosticsForPath(filePath: string): Promise<FileDiagnostic[]> {
  const allDiagnostics = await this.getDiagnostics();
  
  // 标准化输入路径，统一使用正斜杠进行逻辑处理
  const normalizedPath = filePath.replace(/\\/g, '/').toLowerCase();
  
  // 多种匹配策略
  const matchedFiles = allDiagnostics.filter(d => {
    const uri = d.uri.toLowerCase();
    const cleanUri = uri.replace(/^file:\/\/\//, '').replace(/^file:\/\//, '').replace(/\\/g, '/');
    
    // 1. 精确匹配 (处理转换后的路径)
    if (cleanUri === normalizedPath) {
      return true;
    }
    
    // 2. 路径结尾匹配
    if (cleanUri.endsWith('/' + normalizedPath) || cleanUri.endsWith(normalizedPath)) {
      return true;
    }
    
    // 3. 文件名匹配
    const fileName = normalizedPath.split('/').pop() || normalizedPath;
    if (uri.endsWith('/' + fileName)) {
      return true;
    }
    
    // 4. 包含路径匹配
    if (cleanUri.includes(normalizedPath)) {
      return true;
    }
    
    return false;
  });
  
  console.error(`路径匹配结果: 输入=${filePath}, 找到=${matchedFiles.length}个匹配`);
  
  return matchedFiles;
}

src/index.ts:186-215 (handler)

MCP server handler for getDiagnosticsForPath tool: validates input, delegates to VSCodeDiagnosticsClient, handles empty results and errors, formats response as MCP content.

private async handleGetDiagnosticsForPath(args: { filePath: string }) {
  if (!args || !args.filePath) {
    throw new McpError(ErrorCode.InvalidParams, '缺少必需参数: filePath');
  }
  try {
    const diagnostics = await this.diagnosticsClient.getDiagnosticsForPath(args.filePath);
    if (!diagnostics || diagnostics.length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: '未找到匹配该路径的文件。',
          },
        ],
      };
    }
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(diagnostics, null, 2),
        },
      ],
    };
  } catch (error) {
    throw new McpError(
      ErrorCode.InternalError,
      `[handleGetDiagnosticsForPath] ${error instanceof Error ? error.message : String(error)}`
    );
  }

src/index.ts:70-84 (registration)

Registers the getDiagnosticsForPath tool in the MCP listTools response, providing name, description, and input schema.

{
  name: 'getDiagnosticsForPath',
  description: '🌟 推荐工具：根据文件路径获取诊断信息，支持灵活的路径匹配。可以使用相对路径、文件名等多种格式，比 getDiagnosticsForFile 更易用。',
  inputSchema: {
    type: 'object',
    properties: {
      filePath: {
        type: 'string',
        description: '文件路径，支持多种格式：\n- 相对路径：src/index.ts\n- 文件名：index.ts\n- 带目录的文件名：test/TestJava.java\n示例：要查看 index.ts 文件的问题，使用 "src/index.ts" 或 "index.ts"',
      },
    },
    required: ['filePath'],
    additionalProperties: false,
  },
},

src/index.ts:73-82 (schema)

Defines the input schema for the getDiagnosticsForPath tool, specifying the required 'filePath' string parameter.

inputSchema: {
  type: 'object',
  properties: {
    filePath: {
      type: 'string',
      description: '文件路径，支持多种格式：\n- 相对路径：src/index.ts\n- 文件名：index.ts\n- 带目录的文件名：test/TestJava.java\n示例：要查看 index.ts 文件的问题，使用 "src/index.ts" 或 "index.ts"',
    },
  },
  required: ['filePath'],
  additionalProperties: false,

MCP Diagnostics