AI导哈

C2B故障排查服务器

一个基于Spring Boot的C2B服务故障排查服务器，提供自然语言接口、Web界面和命令行工具，适用于开发者和测试人员快速诊断问题。

  • by feb724
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 feb724/c2bs-mcp-troubleshoot

使用说明

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=50

MCP检查员

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_services
  • switch_service

日志分析

  • search_logs
  • tail_log
  • analyze_error_patterns

调试

  • check_service_health
  • debug_request

代码分析

  • search_source_code
  • check_dependencies
  • run_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
  • 梅文
  • 无状态协议

附加文档

相关 MCP