C2B MCP服务器故障排除
Spring Boot MCP服务器,用于对具有自然语言接口功能的C2B服务进行故障排除。使用STATELESS协议与Spring AI MCP Server 1.1.2构建。
概述
该服务器提供了三种与C2B服务交互的访问方法:
| 方法 | 访问 | 用例 |
|---|---|---|
| Web用户界面 | http://localhost:8080/ | 测试人员和非技术用户 |
| 自然语言CLI | ./ask.sh "your question" | 开发人员,快速查询 |
| 直接工具CLI | ./mcp-tool.sh tool_name args | 自动化和脚本 |
详细比较请参见 ACCESS-METHODS.md.
快速开始
./run.sh服务器将在端口8080(MCP端点位于 /mcp,Web用户界面位于 /)在9000端口进行健康检查。
网络界面
访问web界面 http://localhost:8080/ 用于与C2B服务交互的自然语言接口。
主要特点
- 自然语言问题处理
- 预配置的示例查询
- 实时响应处理
- 跨平台兼容性
查询示例
Why doesn't customer 199004275112 qualify for mobile offerings?
Investigate qualification for customer 199004275112
Is the service healthy?
Show me the last 100 log lines
Search logs for error有关完整的测试仪文档,请参阅 测试指南.md.
命令行用法
自然语言接口
./ask.sh "Why doesn't customer 199004275112 qualify for mobile offerings?"
./ask.sh "Is the service healthy?"直接刀具调用
./mcp-tool.sh investigate_qualification customerId=199004275112
./mcp-tool.sh list_services
./mcp-tool.sh search_logs query=error maxLines=50MCP检查员
MCP检查器需要Node.js v22或更高版本。
升级Node.js
# Using nvm (recommended)
nvm install 22
nvm use 22
# Or install latest LTS
nvm install --lts运行检查器
npx @modelcontextprotocol/inspector配置:
- 传输:流式HTTP
- 网址:
http://localhost:8080/mcp - 连接:直接
可用工具
服务器提供10个按类别组织的工具:
服务管理
list_servicesswitch_service
日志分析
search_logstail_loganalyze_error_patterns
调试
check_service_healthdebug_request
代码分析
search_source_codecheck_dependenciesrun_tests
配置
配置文件:
src/main/resources/application.yml-主应用程序配置(STATELESS协议)config/services.yaml-服务特定设置
关键配置: spring.ai.mcp.server.protocol=STATELESS 和 stateless.mcp-endpoint=/mcp
技术栈
- Java 21
- 弹簧靴3.5.8
- Spring AI MCP服务器1.1.2
- 梅文
- 无状态协议
附加文档
- 注释.md -详细的配置说明
- 部署标准.md -部署指南
- MCP-CLIENT-SETUP.md -客户端设置说明
