配置 on 云原生 MCP 服务器

服务器配置

Mon, 01 Jan 0001 00:00:00 +0000

服务器配置#

本文档描述 Cloud Native MCP Server 的服务器基本配置。

运行模式#

服务器支持两种运行模式：

模式	描述	适用场景
`sse`	Server-Sent Events	实时推送，生产环境推荐
`streamable-http`	流式 HTTP	大数据量传输

SSE 模式#

1
2
3
4


server:
 mode: "sse"
 addr: "0.0.0.0:8080"
 writeTimeoutSec: 0 # 保持连接

优势:

实时推送
长连接
适合流式数据

Streamable-HTTP 模式#

1
2
3
4


server:
 mode: "streamable-http"
 addr: "0.0.0.0:8080"
 writeTimeoutSec: 0

优势:

服务配置

Mon, 01 Jan 0001 00:00:00 +0000

服务配置#

本文档描述 Cloud Native MCP Server 集成的各个服务的配置选项。

Kubernetes#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


kubernetes:
 # kubeconfig 文件路径
 # 如果为空，使用默认: $KUBECONFIG → ~/.kube/config → service account
 kubeconfig: ""

 # 单个 API 调用超时（秒）
 timeoutSec: 30

 # API 客户端每秒查询数 (QPS)
 qps: 100.0

 # API 客户端突发速率
 burst: 200

配置建议#

开发环境: qps: 50.0, burst: 100
生产环境: qps: 100.0, burst: 200
大规模集群: qps: 200.0, burst: 400

Prometheus#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


prometheus:
 # 启用/禁用 Prometheus 服务
 enabled: false

 # Prometheus 服务器地址
 # 格式: http://host:port 或 https://host:port
 address: "http://localhost:9090"

 # 请求超时（秒）
 timeoutSec: 30

 # Basic auth 用户名（可选）
 username: ""

 # Basic auth 密码（可选）
 password: ""

 # Bearer token 认证（可选，优先级高于 Basic Auth）
 bearerToken: ""

 # 跳过 TLS 证书验证
 # 生产环境不要使用！
 tlsSkipVerify: false

 # TLS 客户端证书文件路径（用于 mTLS 认证）
 tlsCertFile: ""

 # TLS 客户端密钥文件路径
 tlsKeyFile: ""

 # TLS CA 证书文件路径
 tlsCAFile: ""

查询示例#

1
2
3
4
5
6


{
 "name": "query",
 "arguments": {
 "query": "up{job=\"kubernetes-pods\"}"
 }
}

Grafana#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


grafana:
 # 启用/禁用 Grafana 服务
 enabled: false

 # Grafana 服务器 URL
 # 格式: http://host:port 或 https://host:port
 url: "http://localhost:3000"

 # Grafana API Key（推荐）
 # 在 Grafana 中创建: Administration → API Keys
 apiKey: ""

 # Basic auth 用户名（API Key 的替代方案）
 username: ""

 # Basic auth 密码
 password: ""

 # 请求超时（秒）
 timeoutSec: 30

创建 API Key#

登录 Grafana
导航到 Configuration → API Keys
点击 “Add API Key”
输入名称和过期时间
复制生成的 API Key

Kibana#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


kibana:
 # 启用/禁用 Kibana 服务
 enabled: false

 # Kibana 服务器 URL
 # 格式: http://host:port 或 https://host:port
 url: "https://localhost:5601"

 # Kibana API Key（推荐）
 # 在 Kibana 中创建: Stack Management → API Keys
 apiKey: ""

 # Basic auth 用户名（API Key 的替代方案）
 username: ""

 # Basic auth 密码
 password: ""

 # 请求超时（秒）
 timeoutSec: 30

 # 跳过 TLS 证书验证
 # 生产环境不要使用！
 skipVerify: false

 # Kibana 空间名称
 # 默认: "default"
 space: "default"

Helm#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


helm:
 # 启用/禁用 Helm 服务
 enabled: false

 # Helm 操作 kubeconfig 路径
 # 如果为空，使用与 Kubernetes 客户端相同的 kubeconfig
 kubeconfigPath: ""

 # Helm 操作默认命名空间
 namespace: "default"

 # 启用 Helm 调试模式
 debug: false

 # 仓库更新超时（秒）
 # 默认: 300 (5 分钟)
 # 国内环境推荐: 600-900
 timeoutSec: 300

 # 最大重试次数
 # 失败的仓库更新的重试次数
 # 默认: 3
 # 推荐: 3-5
 maxRetries: 3

 # 启用镜像
 # 用于加速 Helm 仓库拉取
 # 默认: false
 useMirrors: false

 # 自定义镜像映射
 # 格式: 原始仓库 URL -> 镜像 URL
 mirrors: {}

镜像配置示例#

1
2
3
4
5


helm:
 useMirrors: true
 mirrors:
 "https://kubernetes-charts.storage.googleapis.com": "https://mirror.example.com/kubernetes-charts"
 "https://charts.bitnami.com/bitnami": "https://mirror.example.com/bitnami"

Elasticsearch#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


elasticsearch:
 # 启用/禁用 Elasticsearch 服务
 enabled: false

 # Elasticsearch 服务器地址（支持多节点高可用）
 addresses:
 - "http://localhost:9200"

 # 单个 Elasticsearch 服务器地址（addresses 的替代方案）
 # 当 addresses 为空时使用
 address: ""

 # Basic auth 用户名
 username: ""

 # Basic auth 密码
 password: ""

 # Bearer token 认证（可选，优先级高于 Basic Auth）
 bearerToken: ""

 # API Key 认证（可选，最高优先级）
 # 格式: id:api_key
 apiKey: ""

 # 请求超时（秒）
 timeoutSec: 30

 # 跳过 TLS 证书验证
 # 生产环境不要使用！
 tlsSkipVerify: false

 # TLS 客户端证书文件路径（用于 mTLS 认证）
 tlsCertFile: ""

 # TLS 客户端密钥文件路径
 tlsKeyFile: ""

 # TLS CA 证书文件路径
 tlsCAFile: ""

多节点配置#

1
2
3
4
5
6
7
8


elasticsearch:
 enabled: true
 addresses:
 - "http://es-node-1:9200"
 - "http://es-node-2:9200"
 - "http://es-node-3:9200"
 username: "elastic"
 password: "${ES_PASSWORD}"

Alertmanager#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


alertmanager:
 # 启用/禁用 Alertmanager 服务
 enabled: false

 # Alertmanager 服务器地址
 # 格式: http://host:port 或 https://host:port
 address: "http://localhost:9093"

 # 请求超时（秒）
 timeoutSec: 30

 # Basic auth 用户名（可选）
 username: ""

 # Basic auth 密码（可选）
 password: ""

 # Bearer token 认证（可选，优先级高于 Basic Auth）
 bearerToken: ""

 # 跳过 TLS 证书验证
 # 生产环境不要使用！
 tlsSkipVerify: false

 # TLS 客户端证书文件路径（用于 mTLS 认证）
 tlsCertFile: ""

 # TLS 客户端密钥文件路径
 tlsKeyFile: ""

 # TLS CA 证书文件路径
 tlsCAFile: ""

OpenTelemetry#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


opentelemetry:
 # 启用/禁用 OpenTelemetry 服务
 enabled: false

 # OpenTelemetry Collector 地址
 # 格式: http://host:port 或 https://host:port
 address: "http://localhost:4318"

 # 请求超时（秒）
 timeoutSec: 30

 # Basic auth 用户名（可选）
 username: ""

 # Basic auth 密码（可选）
 password: ""

 # Bearer token 认证（可选，优先级高于 Basic Auth）
 bearerToken: ""

 # 跳过 TLS 证书验证
 # 生产环境不要使用！
 tlsSkipVerify: false

 # TLS 客户端证书文件路径（用于 mTLS 认证）
 tlsCertFile: ""

 # TLS 客户端密钥文件路径
 tlsKeyFile: ""

 # TLS CA 证书文件路径
 tlsCAFile: ""

Utilities#

1
2
3


utilities:
 # Utilities 服务始终启用
 enabled: true

服务启用/禁用#

1
2
3
4
5
6
7
8
9


enableDisable:
 # 禁用的服务（逗号分隔）
 disabledServices: []

 # 启用的服务（逗号分隔，覆盖禁用列表）
 enabledServices: []

 # 禁用的工具（逗号分隔）
 disabledTools: []

示例#

1
2
3
4
5
6
7
8


# 仅启用 Kubernetes 和 Prometheus
enableDisable:
 enabledServices: ["kubernetes", "prometheus"]
 disabledServices: ["elasticsearch", "kibana", "grafana"]

# 禁用特定工具
enableDisable:
 disabledTools: ["delete_pod", "delete_deployment"]

配置验证#

服务器在启动时验证每个服务的配置：

认证配置

Mon, 01 Jan 0001 00:00:00 +0000

认证配置#

本文档描述 Cloud Native MCP Server 的认证和授权配置。

认证模式#

服务器支持三种认证模式：

模式	描述	使用场景
`apikey`	API Key 认证	简单场景，快速部署
`bearer`	Bearer Token 认证	JWT token，更安全
`basic`	HTTP Basic Auth	传统认证方式

API Key 认证#

配置#

1
2
3
4
5
6
7
8
9


auth:
 # 启用/禁用认证
 enabled: true

 # 认证模式
 mode: "apikey"

 # API Key
 apiKey: "Abc123!@#Xyz789!@#Abc123!@#"

使用方式#

1
2
3


# 使用 curl
curl -H "X-API-Key: Abc123!@#Xyz789!@#" \
 http://localhost:8080/api/kubernetes/sse/message

API Key 复杂度要求#

最小长度: 16 个字符
字符类型: 以下 4 种类型中至少包含 3 种：
- 大写字母 (A-Z)
- 小写字母 (a-z)
- 数字 (0-9)
- 特殊字符 (!@#$%^&*()_+-=[]{}|;:,.<>?)

有效示例#

Abc123!@#Xyz789!@# (大写、小写、数字、特殊字符)
Abc123Xyz789Abc123 (大写、小写、数字)
ABC123!@#XYZ789!@# (大写、数字、特殊字符)

Bearer Token 认证#

配置#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


auth:
 enabled: true
 mode: "bearer"
 bearerToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

 # JWT 密钥（用于 JWT 验证）
 jwtSecret: "your-jwt-secret-key"

 # JWT 算法 (HS256, RS256, etc.)
 jwtAlgorithm: "HS256"

使用方式#

1
2
3


# 使用 curl
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
 http://localhost:8080/api/kubernetes/sse/message

Bearer Token 要求#

格式: header.payload.signature
最小长度: 32 个字符
编码: Base64URL 编码的各部分
验证: 每个部分必须只包含有效的 base64url 字符

JWT Token 结构#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


{
 "header": {
 "alg": "HS256",
 "typ": "JWT"
 },
 "payload": {
 "sub": "user123",
 "name": "John Doe",
 "iat": 1516239022
 },
 "signature": "SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Basic 认证#

配置#

1
2
3
4
5


auth:
 enabled: true
 mode: "basic"
 username: "admin"
 password: "secure-password"

使用方式#

1
2
3
4
5
6
7


# 使用 curl
curl -u admin:secure-password \
 http://localhost:8080/api/kubernetes/sse/message

# 或者使用 Authorization 头
curl -H "Authorization: Basic YWRtaW46c2VjdXJlLXBhc3N3b3Jk" \
 http://localhost:8080/api/kubernetes/sse/message

Base64 编码#

1
2
3


# 编码用户名和密码
echo -n "admin:secure-password" | base64
# 输出: YWRtaW46c2VjdXJlLXBhc3N3b3Jk

环境变量认证#

使用环境变量配置认证：