MaxKB最终配置指南.md•2.65 kB
# MaxKB MCP配置最终指南
## 问题分析
MaxKB报错 `[ErrorDetail(string='MCP configuration is invalid', code='invalid')]` 的原因是：
1. **缺少初始化流程** - MaxKB期望完整的MCP协议握手
2. **响应格式问题** - 需要标准的JSON-RPC 2.0格式
3. **协议版本不匹配** - 需要正确的MCP协议版本
## 解决方案
### 1. 使用MaxKB专用MCP服务器
我已经创建了专门为MaxKB设计的MCP服务器，支持完整的协议握手。
**启动服务器：**
```bash
cd /Users/ywt/PycharmProjects/mcp/src
python maxkb_mcp_server.py
```
### 2. MaxKB配置
使用以下配置：
```json
{
"employee_management": {
"url": "http://172.20.10.2:8000/mcp",
"transport": "streamable_http"
}
}
```
### 3. 验证服务器
服务器现在支持以下MCP协议方法：
- ✅ `initialize` - 初始化握手
- ✅ `tools/list` - 获取工具列表
- ✅ `tools/call` - 调用工具
- ✅ `ping` - 健康检查
## 测试验证
### 1. 健康检查
```bash
curl http://172.20.10.2:8000/health
```
### 2. 初始化测试
```bash
curl -X POST http://172.20.10.2:8000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "maxkb", "version": "1.0.0"}}, "id": "init"}'
```
### 3. 工具列表测试
```bash
curl -X POST http://172.20.10.2:8000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "params": {}, "id": "tools_list"}'
```
## 关键修复
### 1. 添加了initialize方法
MaxKB在连接时会发送初始化请求，服务器必须正确响应。
### 2. 标准JSON-RPC格式
所有响应都使用标准的JSON-RPC 2.0格式。
### 3. 正确的协议版本
使用MCP协议版本 "2024-11-05"。
## 配置步骤
1. **启动MaxKB专用MCP服务器**
2. **在MaxKB中配置MCP服务器**
3. **测试连接**
4. **开始使用自然语言与员工管理系统交互**
## 可用功能
配置成功后，你可以在MaxKB中使用以下自然语言：
- "帮我查看所有员工"
- "查询ID为1的员工信息"
- "添加一个新员工，名字叫张三，工资8000"
- "搜索姓氏为'李'的员工"
- "显示所有在职员工"
- "查看所有高级员工"
## 故障排除
如果仍然有问题：
1. **检查服务器日志** - 查看详细的请求和响应
2. **验证网络连接** - 确保MaxKB能访问MCP服务器
3. **检查MaxKB版本** - 确保使用支持MCP的版本
4. **查看MaxKB日志** - 获取更详细的错误信息
现在请重新在MaxKB中配置，应该可以正常工作了！