# MCP 工具概述

AgentFox 提供 5 个 MCP 工具，采用渐进式下钻设计，让 LLM 按需获取精确信息。

## 设计理念

传统方式是将完整 API 规范一次性提供给 LLM（10,000+ tokens）。AgentFox 将信息分层，LLM 按需逐层获取：

```
get_project_overview          ← 项目级：名称、版本、模块摘要（~200 tokens）
    │
    ├── list_modules          ← 模块级：模块描述和端点数量（~100-300 tokens）
    │       │
    │       └── list_endpoints    ← 端点列表：方法、路径、摘要（~200-500 tokens）
    │               │
    │               └── get_endpoint_detail  ← 端点详情：参数、请求体、响应（~500-2000 tokens）
    │
    └── search_endpoints      ← 关键词搜索：跨模块搜索端点（~200-500 tokens）
```

## 推荐调用流程

对于典型的 API 集成任务，LLM 通常会按以下顺序调用：

1. **`get_project_overview`** — 了解项目结构和可用模块
2. **`list_endpoints`** — 浏览目标模块的端点列表（或用 `search_endpoints` 搜索）
3. **`get_endpoint_detail`** — 获取目标端点的完整信息

大多数任务只需要 2-3 次调用，总共约 1,000-1,500 tokens。

## Token 消耗对比

| 工具 | 平均 Token 消耗 | 说明 |
|------|----------------|------|
| `get_project_overview` | ~200 | 最轻量，建议首先调用 |
| `list_modules` | ~100-300 | 按模块数量线性增长 |
| `list_endpoints` | ~200-500 | 按端点数量线性增长 |
| `get_endpoint_detail` | ~500-2,000 | 取决于参数和响应 schema 复杂度 |
| `search_endpoints` | ~200-500 | 最多返回 20 条结果 |
| **全量 OpenAPI 规范** | **10,000-100,000+** | 传统方式 |

## 工具列表

- [`get_project_overview`](get-project-overview.md) — 获取项目概览
- [`list_modules`](list-modules.md) — 列出所有模块
- [`list_endpoints`](list-endpoints.md) — 列出模块中的端点
- [`get_endpoint_detail`](get-endpoint-detail.md) — 获取端点完整详情
- [`search_endpoints`](search-endpoints.md) — 按关键词搜索端点