# adk_mcp

[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | 中文

`adk_mcp` 提供 Dart 版 MCP（Model Context Protocol）客户端基础能力。

## 提供内容

- Streamable HTTP MCP 客户端 (`McpRemoteClient`)
- stdio MCP 客户端 (`McpStdioClient`)
- MCP 常量、方法名、协议版本协商、JSON-RPC 辅助方法

## 平台支持矩阵（当前）

状态说明:

- `Y` 支持
- `Partial` 部分支持/环境相关
- `N` 不支持

| 功能/接口 | Dart VM / CLI | Flutter (Android/iOS/Linux/macOS/Windows) | Flutter Web | 说明 |
| --- | --- | --- | --- | --- |
| `McpRemoteClient` (Streamable HTTP) | Y | Y | Y | HTTP/HTTPS 传输 |
| 协议协商 + JSON-RPC 辅助方法 | Y | Y | Y | 各平台行为一致 |
| 服务端消息读取 (`readServerMessagesOnce`) | Y | Y | Y | Web 端可能需要 CORS 可用的 MCP 服务端 |
| `McpStdioClient` | Y | Partial | N | Web stub 会抛 `UnsupportedError` |
| `StdioConnectionParams` + `Process.start` | Y | Partial | N | 依赖本地进程能力/策略 |
| HTTP 会话终止 (`terminateSession`) | Y | Y | Y | 使用 MCP Streamable HTTP DELETE 流程 |
| 内置凭证/令牌生命周期管理器 | N | N | N | 由调用方自行管理 headers/tokens |

## ADK 2.0 兼容性

本包与 ADK 2.0 保持一致，支持远程 MCP 服务端集成、Managed Agent 配置以及适用于混合 Agent 执行的 GCP Managed Agents Interactions API。

## 安装

```bash
dart pub add adk_mcp
```

## 参考

- 详细说明: [README.md](README.md)
- 仓库: <https://github.com/adk-labs/adk_dart>
