66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
# 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 分钟完成首次配置
|