apifox-workspace-mcp

列出当前工作空间中已集成的所有 Apifox 项目。使用场景：当用户询问"有哪些项目"、"列出所有项目"、"项目列表"时调用此工具。返回项目名称、ID 和接口数量，帮助用户了解当前可用的项目。

解析 Apifox 分享链接并添加到项目配置中。使用场景：当用户提供 Apifox 分享链接（项目链接或接口链接）时，自动解析项目信息、接口列表并缓存到本地。这是使用其他工具的前提步骤，必须先添加项目才能查询接口。支持项目级链接和接口级链接两种格式。**缓存管理**：添加项目时会自动设置缓存过期时间（根据 MCP 配置的 TTL），并计算内容 Hash 用于后续版本检测。如果项目已存在，会更新项目信息和接口列表。

在指定项目中搜索和查询接口，支持关键词、路径、标签等多种过滤方式。使用场景：当用户询问"查询XX接口"、"搜索XX"、"找XX接口"、"有哪些XX接口"时调用此工具。返回匹配的接口列表，包含接口 ID、名称、路径、方法等信息，每个接口都有编号便于后续选择。如果用户提到接口路径（如 /api/login），使用 keyword 参数传入路径进行搜索。**自动刷新机制**：此工具会在查询前自动检查缓存是否过期或内容是否更新，必要时会自动刷新缓存以确保数据最新。如果用户明确要求"刷新"或"更新"，应优先使用 refresh_project_cache 工具。

获取指定接口的完整详细信息，包括请求参数（headers、cookies、query、path、body）、响应结构、curl 示例、fetch 示例和 TypeScript 类型。使用场景：当用户询问"XX接口的详情"、"告诉我XX接口的信息"、"查看XX接口"、或提供了包含 interfaceId 的 Apifox 接口链接时调用此工具。返回的接口详情可用于代码生成、API 调用等场景。**自动刷新机制**：此工具会在获取详情前自动检查缓存是否过期或内容是否更新，必要时会自动刷新缓存以确保数据最新。如果用户明确要求"刷新"或"更新"，应优先使用 refresh_project_cache 工具。

根据接口详情生成代码产物，包括 TypeScript 类型、Mock 数据、请求封装函数或测试脚本。使用场景：当用户要求"生成XX接口的类型"、"生成XX的 Mock 数据"、"生成XX的请求封装"、"生成XX的测试脚本"时调用此工具。支持批量生成多个接口的代码。通常需要先调用 query_interfaces 或 get_interface_detail 获取 interfaceId，然后调用此工具生成代码。

从上次查询的接口列表中选择多个接口，用于批量操作（如批量生成代码）。使用场景：当用户说"选择接口 1, 3, 5"、"选择接口 1-5"、"选择包含支付的接口"时调用此工具。选择后的接口会保存在上下文中，后续可以调用 generate_artifacts 批量生成代码。注意：必须先调用 query_interfaces 获取接口列表，然后才能选择。

刷新指定项目的缓存数据，确保获取最新的接口信息。使用场景：当用户询问"刷新XX项目的缓存"、"更新XX项目的数据"、"重新加载XX项目"、"强制更新XX项目"时调用此工具。支持强制刷新（忽略缓存直接更新）和智能刷新（仅在缓存过期或内容变化时更新）。如果用户明确要求"强制刷新"、"立即更新"、"忽略缓存"，使用 force: true 参数。返回刷新结果、原因和接口数量。