explore_huggingface_repo

Explore and visualize the directory structure of HuggingFace repositories to understand file organization and locate specific model components.

Instructions

探索 HuggingFace 仓库的目录结构，返回层级化的文件树

Input Schema

TableJSON Schema

Name	Required	Description	Default
`repo_id`	Yes	HuggingFace 仓库 ID（格式：owner/repo）
`revision`	No	Git 分支或标签	main
`max_depth`	No	最大扫描深度
`tree_view`	No	是否生成ASCII树形视图

Implementation Reference

src/mcp/tools.js:344-388 (handler)

Main handler function for 'explore_huggingface_repo' tool. Validates input, configures options with 'explore' mode, calls downloader.list(), and returns formatted result or error.

async callExploreTool(args) {
  try {
    // 基础验证
    if (!args.repo_id) {
      return CallToolResult.error(
        ToolContent.text('缺少必需参数: repo_id')
      );
    }

    logger.info(`探索仓库: ${args.repo_id}`);

    // 构建选项
    const options = {
      revision: args.revision,
      maxDepth: args.max_depth,
      mode: 'explore', // 探索模式
      treeView: args.tree_view,
      token: args.token || process.env.HF_TOKEN
    };

    // 执行探索
    const result = await this.downloader.list(args.repo_id, options);

    if (result.success) {
      logger.info(`探索完成: 深度${result.stats?.depth || 0}`);
      return CallToolResult.success(
        ToolContent.text(JSON.stringify(result, null, 2))
      );
    } else {
      logger.error('探索失败:', result.error);
      return CallToolResult.error(
        ToolContent.text(JSON.stringify({
          success: false,
          error: result.error,
          suggestions: result.suggestions
        }, null, 2))
      );
    }
  } catch (error) {
    logger.error('工具调用失败:', error);
    return CallToolResult.error(
      ToolContent.text(`工具调用失败: ${error.message}`)
    );
  }
}

src/mcp/tools.js:86-117 (schema)

Schema definition for 'explore_huggingface_repo' tool, including name, description, input properties (repo_id required, others optional), and JSON schema.

getExploreTool() {
  return new Tool(
    'explore_huggingface_repo',
    '探索 HuggingFace 仓库的目录结构，返回层级化的文件树',
    {
      type: 'object',
      properties: {
        repo_id: {
          type: 'string',
          description: 'HuggingFace 仓库 ID（格式：owner/repo）',
          examples: ['2Noise/ChatTTS', 'microsoft/DialoGPT-medium']
        },
        revision: {
          type: 'string',
          description: 'Git 分支或标签',
          default: 'main'
        },
        max_depth: {
          type: 'integer',
          description: '最大扫描深度',
          default: 3
        },
        tree_view: {
          type: 'boolean',
          description: '是否生成ASCII树形视图',
          default: false
        }
      },
      required: ['repo_id']
    }
  );
}

src/mcp/tools.js:24-31 (registration)
Tool registration in getTools() method, which returns the list of available tools including explore_huggingface_repo via getExploreTool().
```
getTools() {
  return [
    this.getDownloadTool(),
    this.getListTool(),
    this.getExploreTool(),
    this.getSearchTool()
  ];
}
```
src/mcp/tools.js:452-453 (registration)
Dispatch registration in the callTool switch statement, mapping 'explore_huggingface_repo' to the callExploreTool handler.
```
case 'explore_huggingface_repo':
  return await this.callExploreTool(args);
```

MCP HuggingFetch