scan_dependencies

Scans Maven project dependencies to create a class-to-JAR mapping index for accurate Java code analysis and dependency resolution.

Instructions

扫描Maven项目的所有依赖，建立类名到JAR包的映射索引

Input Schema

TableJSON Schema

Name	Required	Description	Default
`projectPath`	Yes	Maven项目根目录路径
`forceRefresh`	No	是否强制刷新索引

Implementation Reference

src/scanner/DependencyScanner.ts:31-102 (handler)

Core logic implementing the dependency scanning: gets Maven deps, extracts classes from each JAR, builds index, caches to .mcp-class-index.json.

async scanProject(projectPath: string, forceRefresh: boolean = false): Promise<ScanResult> {
    const indexPath = path.join(projectPath, '.mcp-class-index.json');
    const isDebug = process.env.NODE_ENV === 'development';

    // 如果强制刷新，先删除旧的索引文件
    if (forceRefresh && await fs.pathExists(indexPath)) {
        if (isDebug) {
            console.error('强制刷新：删除旧的索引文件');
        }
        await fs.remove(indexPath);
    }

    // 检查缓存
    if (!forceRefresh && await fs.pathExists(indexPath)) {
        if (isDebug) {
            console.error('使用缓存的类索引');
        }
        const cachedIndex = await fs.readJson(indexPath);
        return {
            jarCount: cachedIndex.jarCount,
            classCount: cachedIndex.classCount,
            indexPath,
            sampleEntries: cachedIndex.sampleEntries
        };
    }

    if (isDebug) {
        console.error('开始扫描Maven依赖...');
    }

    // 1. 获取Maven依赖树
    const dependencies = await this.getMavenDependencies(projectPath);
    console.error(`找到 ${dependencies.length} 个依赖JAR包`);

    // 2. 解析每个JAR包，建立类索引
    const classIndex: ClassIndexEntry[] = [];
    let processedJars = 0;

    for (const jarPath of dependencies) {
        try {
            const classes = await this.extractClassesFromJar(jarPath);
            classIndex.push(...classes);
            processedJars++;

            if (processedJars % 10 === 0) {
                console.error(`已处理 ${processedJars}/${dependencies.length} 个JAR包`);
            }
        } catch (error) {
            console.warn(`处理JAR包失败: ${jarPath}, 错误: ${error}`);
        }
    }

    // 3. 保存索引到文件
    const result: ScanResult = {
        jarCount: processedJars,
        classCount: classIndex.length,
        indexPath,
        sampleEntries: classIndex.slice(0, 10).map(entry =>
            `${entry.className} -> ${path.basename(entry.jarPath)}`
        )
    };

    await fs.outputJson(indexPath, {
        ...result,
        classIndex,
        lastUpdated: new Date().toISOString()
    }, { spaces: 2 });

    console.error(`扫描完成！处理了 ${processedJars} 个JAR包，索引了 ${classIndex.length} 个类`);

    return result;
}

src/index.ts:147-164 (handler)

MCP server handler for scan_dependencies tool call: extracts args, calls DependencyScanner, returns MCP-formatted response.

private async handleScanDependencies(args: any) {
    const { projectPath, forceRefresh = false } = args;

    const result = await this.scanner.scanProject(projectPath, forceRefresh);

    return {
        content: [
            {
                type: 'text',
                text: `依赖扫描完成！\n\n` +
                    `扫描的JAR包数量: ${result.jarCount}\n` +
                    `索引的类数量: ${result.classCount}\n` +
                    `索引文件路径: ${result.indexPath}\n\n` +
                    `示例索引条目:\n${result.sampleEntries.slice(0, 5).join('\n')}`,
            },
        ],
    };
}

src/index.ts:54-68 (schema)

Input JSON Schema for scan_dependencies tool.

inputSchema: {
    type: 'object',
    properties: {
        projectPath: {
            type: 'string',
            description: 'Maven项目根目录路径',
        },
        forceRefresh: {
            type: 'boolean',
            description: '是否强制刷新索引',
            default: false,
        },
    },
    required: ['projectPath'],
},

src/index.ts:123-125 (registration)
Registration of tool handlers in CallToolRequestSchema switch statement.
```
switch (name) {
    case 'scan_dependencies':
        return await this.handleScanDependencies(args);
```

src/index.ts:51-69 (registration)

Tool metadata registration (name, desc, schema) in ListToolsRequestSchema handler.

{
    name: 'scan_dependencies',
    description: '扫描Maven项目的所有依赖，建立类名到JAR包的映射索引',
    inputSchema: {
        type: 'object',
        properties: {
            projectPath: {
                type: 'string',
                description: 'Maven项目根目录路径',
            },
            forceRefresh: {
                type: 'boolean',
                description: '是否强制刷新索引',
                default: false,
            },
        },
        required: ['projectPath'],
    },
},

Java Class Analyzer MCP Server