第 5 卷
# 添加 Python 脚本 codebuddy mcp add --scope project python-tool -- python /path/to/script.py
SSE服务器
bash
# 添加 SSE 服务器 codebuddy mcp add --scope user --transport sse sse-server https://example.com/m
HTTP服务器
bash
# 添加 HTTP 流式服务器 codebuddy mcp add --scope project --transport http http-server https://example.
使用JSON配置添加服务器
bash
# 添加 STDIO 类型服务器 codebuddy mcp add-json --scope user my-server '{"type":"stdio","command":"/usr/
# 添加 HTTP 类型服务器 codebuddy mcp add-json --scope user http-server '{"type":"http","url":"https://
# 添加 SSE 类型服务器 codebuddy mcp add-json --scope project sse-server '{"type":"sse","url":"https:/
# 添加带环境变量的 STDIO 服务器 codebuddy mcp add-json --scope user python-tool '{"type":"stdio","command":"pyt
管理MCP服务器
列出所有服务器
bash
# 列出所有作用域的服务器 codebuddy mcp list
查看服务器详情
bash
# 查看特定服务器信息 codebuddy mcp get my-server
bash
# 移除特定服务器 codebuddy mcp remove my-server
# 移除特定作用域的服务器 codebuddy mcp remove my-server --scope user
最佳实践
1.作用域选择
使用 user 作用域存储个人工具和全局服务
使用 project 作用域存储项目特定的工具
使用 local 作用域存储临时或实验性工具
2.安全考虑
避免在配置文件中存储敏感信息
使用环境变量传递认证信息：利用 MCP 的环境变量扩展功能（ ${API_TOKEN} 或 ${API_TOKEN:-default}）来管理 API 密钥、令牌等敏感数据
定期审查和更新服务器配置
项目作用域的 MCP 服务器需要用户审批后才能连接，确保安全性
OAuth授权 URL 会在打开前进行安全验证，仅支持 http/https协议
将包含环境变量引用的配置文件提交到版本控制系统，但在 .gitignore 中排除实际的环境变量文件
3.性能优化
合理配置服务器超时时间
避免同时运行过多的 STDIO服务器
使用缓存机制减少重复连接
4.错误处理
监控服务器连接状态
实现重连机制
记录和分析错误日志
故障排除
常见问题
服务器连接失败
1.检查命令路径是否正确
2.验证参数和环境变量
3.确认网络连接（对于远程服务器）
4.查看服务器日志输出
工具不可用
1.确认服务器已成功连接
2.检查工具权限设置
3.验证工具兼容性
配置不生效
1.检查配置文件语法
2.确认作用域优先级
3.重启 CodeBuddy 应用
示例配置
Python工具服务器
json
{ "mcpServers": { "python-tools": { "type": "stdio", "command": "python", "args": ["-m", "my_mcp_server"], "env": { "PYTHONPATH": "/path/to/tools"
}, "description": "Python 工具集合"
} } }
远程API服务器
json
{