# integrateMCP

## 规则（Rules）

# MCP协议联调 - 规范

## 1. MCP核心概念
- **Tools（工具）**：Server暴露的可调用函数，有参数和返回值
- **Resources（资源）**：Server暴露的可读数据
- **Prompts（提示）**：Server提供的可复用提示模板
- **Transport（传输层）**：stdio（本地进程通信）或SSE（HTTP流）

## 2. 联调规范
- 禁止在未确认inputSchema的情况下调用工具
- 禁止忽略MCP返回的content结构（MCP统一使用content数组包裹返回数据）
- 禁止直接修改MCP Server的协议实现

## 3. 工具定义规范
工具必须正确定义 `name`、`description`、`inputSchema`，参数使用JSON Schema格式。

## 方法（Methods）

# MCP协议联调 - 方法

## 流程概览
```
阅读MCP协议文档 → 检查Server实现 → 检查客户端调用 → 编写数据转换 → 逐项验证 → 修复问题
```

## 步骤1：阅读MCP协议文档
提取传输方式、启动命令、所有Tools/Resources/Prompts列表。

## 步骤2：检查MCP Server实现
检查工具注册（name/description/inputSchema）、资源注册、服务初始化。

## 步骤3：检查客户端调用
检查MCP客户端连接配置、参数名和类型是否匹配。

## 步骤4：编写数据转换协议
参数名转换、错误格式统一、资源内容解析。

## 步骤5：逐项验证
工具调用验证、资源读取验证、Prompt验证。

## 步骤6：修复问题
分类处理工具定义错误、参数不匹配、返回值格式不符、连接问题。

## 技巧（Tips）

# MCP协议联调 - 技巧

## 1. 从源码提取规范
协议文档不存在时，直接从Server源码中提取工具定义和参数Schema。

## 2. 统一错误处理
将MCP错误格式统一为应用内部错误格式，便于前端统一处理。

## 3. 资源内容解析
MCP资源返回的content数组需要解析，提取text内容后再处理。