Siriusec MCP

Siriusec MCP Server

Siriusec MCP 是一个为 AI 系统提供 MCP（Model Context Protocol）协议接入能力的 Go 语言服务器。

项目概述

Siriusec MCP 实现了 MCP 标准协议的统一网关，支持多种传输模式，并深度集成阿里云 OpenAPI 生态（SysOM 监控服务）。

核心特性

• MCP 协议网关: 统一接入点 /mcp/unified
• 多传输模式支持: stdio、SSE、Streamable-HTTP
• 阿里云生态集成: SysOM 监控、OpenAPI、DashScope
• 系统诊断工具: 内存、IO、网络、调度等多维度诊断
• 崩溃诊断代理: VMCORE 分析与诊断任务管理

功能模块

Siriusec_MCP 网关
├── MCP 协议网关
│   ├── 协议解析
│   ├── 统一接入 /mcp/unified
│   └── 流式响应 (SSE / Streamable-HTTP)
├── 云服务集成
│   ├── 阿里云 SysOM 监控
│   ├── 通用 OpenAPI
│   └── 通义千问 DashScope
└── 系统诊断工具
    ├── AM 工具 (实例/集群/Pod 管理)
    ├── CrashAgent (崩溃诊断)
    ├── IO 诊断 (iofsstat/iodiagnose)
    ├── 内存诊断 (memgraph/javamem/oomcheck)
    ├── 网络诊断 (packetdrop/netjitter)
    └── 调度诊断 (delay/loadtask)

快速开始

环境要求

• Go 1.25+
• Docker (可选)
• 阿里云账号及 AccessKey

安装

# 克隆仓库
git clone 
cd siriusec-mcp

# 构建
./build.sh local
# 或
go build -o bin/siriusec-mcp cmd/server/main.go

配置

创建 .env 文件：

# OpenAPI 配置
OPENAPI_TYPE=access_key
OPENAPI_ACCESS_KEY_ID=your-access-key-id
OPENAPI_ACCESS_KEY_SECRET=your-access-key-secret
REGION_ID=cn-hangzhou

# 可选: LLM 配置
DASHSCOPE_API_KEY=your-dashscope-api-key

# 日志级别
LOG_LEVEL=INFO

验证配置：

./bin/siriusec-mcp config validate

运行

# stdio 模式 (默认)
./bin/siriusec-mcp run

# SSE 模式
./bin/siriusec-mcp run --sse --host 0.0.0.0 --port 7140

# Streamable-HTTP 模式
./bin/siriusec-mcp run --streamable-http --host 0.0.0.0 --port 7140

工具列表

CLI 命令

Siriusec MCP 提供强大的命令行工具：

# 查看版本
./bin/siriusec-mcp version

# 列出所有工具
./bin/siriusec-mcp tools list
./bin/siriusec-mcp tools list --format json
./bin/siriusec-mcp tools list --format table

# 验证配置
./bin/siriusec-mcp config validate

# 自测工具
./bin/siriusec-mcp selftest
./bin/siriusec-mcp selftest --filter am
./bin/siriusec-mcp selftest -v

# 测试 MCP 服务器连接
./bin/siriusec-mcp mcptest
./bin/siriusec-mcp mcptest --url http://remote:7140

# 查看帮助
./bin/siriusec-mcp help

Docker 部署

# 构建镜像
docker build -t siriusec-mcp:latest .

# 运行 (stdio 模式)
docker run -i --rm \
  -e OPENAPI_ACCESS_KEY_ID=$ACCESS_KEY_ID \
  -e OPENAPI_ACCESS_KEY_SECRET=$ACCESS_KEY_SECRET \
  siriusec-mcp:latest

# 运行 (SSE 模式)
docker run -d \
  -p 7140:7140 \
  -e OPENAPI_ACCESS_KEY_ID=$ACCESS_KEY_ID \
  -e OPENAPI_ACCESS_KEY_SECRET=$ACCESS_KEY_SECRET \
  siriusec-mcp:latest \
  run --sse --host 0.0.0.0 --port 7140

项目结构

.
├── cmd/server/          # 主程序入口
├── internal/
│   ├── cli/             # CLI 命令实现
│   ├── client/          # OpenAPI 客户端
│   ├── config/          # 配置管理
│   ├── logger/          # 日志模块 (zap)
│   ├── mcp/             # MCP 服务器核心
│   ├── registry/        # API 路由注册表
│   ├── tools/           # 工具实现
│   │   ├── am/          # 应用管理工具
│   │   ├── crashagent/  # 崩溃诊断代理
│   │   ├── diagnosis/   # 诊断基类
│   │   ├── initial/     # 初始化服务
│   │   ├── iodiag/      # IO 诊断
│   │   ├── memdiag/     # 内存诊断
│   │   ├── netdiag/     # 网络诊断
│   │   ├── otherdiag/   # 其他诊断
│   │   └── scheddiag/   # 调度诊断
│   └── version/         # 版本信息
├── pkg/models/          # 数据模型
├── test/                # 测试
│   ├── integration/     # 集成测试
│   └── unit/            # 单元测试
├── build.sh             # 多平台构建脚本
├── Dockerfile
├── docker-compose.yml
└── go.mod

测试

# 运行所有测试
go test ./...

# 运行单元测试
go test ./test/unit/...

# 运行集成测试
go test ./test/integration/...

# 带覆盖率
go test -cover ./...

技术栈

• 语言: Go 1.25
• MCP 协议: mark3labs/mcp-go
• 阿里云 SDK: alibabacloud-go/sysom-20231230
• 日志: uber-go/zap (结构化 JSON 日志)
• 配置: joho/godotenv
• 构建: 多平台构建脚本 (build.sh)

许可证

MIT License