# MCP 协议介绍

MCP（Model Context Protocol）是由 Anthropic 推出的开放标准协议，用于连接 AI 助手与外部工具和数据源。

## 什么是 MCP？

你可以把 MCP 理解为 AI 世界的 "USB 接口"：

- **统一标准**：一个协议连接所有 AI 工具和数据源
- **双向通信**：AI 助手可以调用工具，也可以接收数据
- **安全可控**：每个连接都有明确的权限和认证机制

```
┌────────────┐         MCP 协议         ┌────────────┐
│            │◀────────────────────────▶│            │
│  MCP 客户端  │    Streamable HTTP      │  MCP 服务器  │
│ (AI 工具)   │                         │ (数据源/工具) │
│            │    Tools / Resources     │            │
└────────────┘                         └────────────┘

  Claude Code                           AgentFox
  Cursor                                数据库
  Copilot                               文件系统
  ...                                   ...
```

## MCP 的核心概念

### Tools（工具）

MCP 服务器可以向客户端暴露一组工具（函数），AI 助手可以调用这些工具来获取信息或执行操作。

AgentFox 提供 5 个工具：
- `get_project_overview` — 获取项目概览
- `list_modules` — 列出所有模块
- `list_endpoints` — 列出模块中的端点
- `get_endpoint_detail` — 获取端点详情
- `search_endpoints` — 搜索端点

### Transport（传输层）

MCP 支持多种传输方式。AgentFox 使用 **Streamable HTTP** 传输，这意味着：
- 无需安装任何本地插件
- 通过标准 HTTP 请求通信
- 支持远程连接，适合云端部署

## AgentFox 如何使用 MCP？

AgentFox 是一个 **MCP 服务器**，它：

1. 接收你的 OpenAPI 文档并解析索引
2. 为每个项目生成唯一的 MCP 端点 URL
3. 通过 5 个 MCP 工具提供按需查询能力
4. AI 工具（MCP 客户端）连接到这个端点，即可按需查询 API 文档

你的 AI 工具（如 Claude Code、Cursor）就是 **MCP 客户端**，它们通过 MCP 协议连接 AgentFox，获取所需的 API 信息。

## 了解更多

- [MCP 官方文档](https://modelcontextprotocol.io/)
- [MCP 规范](https://spec.modelcontextprotocol.io/)

## 下一步

- [快速开始](../getting-started/README.md) — 5 分钟完成首次配置