配置指南#
本指南涵盖 Cloud Native MCP Server 的所有配置选项。
配置方法#
K8s MCP Server 支持三种配置方法（按优先级排序）：
- 命令行参数 - 最高优先级
- 环境变量 - 中等优先级
- YAML 配置文件 - 最低优先级
配置优先级示例#
1
2
3
4
5
6
7
| # 配置文件设置默认值
# 环境变量覆盖配置文件
# 命令行参数覆盖所有设置
./cloud-native-mcp-server \
--config=config.yaml \
--log-level=debug
|
快速开始#
最小配置#
1
2
3
4
5
6
7
8
9
| server:
mode: "sse"
addr: "0.0.0.0:8080"
logging:
level: "info"
kubernetes:
kubeconfig: ""
|
完整监控栈#
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
| server:
mode: "sse"
addr: "0.0.0.0:8080"
logging:
level: "info"
json: false
kubernetes:
kubeconfig: ""
grafana:
enabled: true
url: "http://localhost:3000"
apiKey: "${GRAFANA_API_KEY}"
prometheus:
enabled: true
address: "http://localhost:9090"
audit:
enabled: true
storage: "memory"
format: "json"
|
环境变量替换#
可以在 YAML 配置文件中使用环境变量：
1
2
3
4
5
6
| grafana:
url: "${GRAFANA_URL}"
apiKey: "${GRAFANA_API_KEY}"
auth:
apiKey: "${MCP_AUTH_API_KEY}"
|
在启动服务器前设置环境变量：
1
2
3
4
5
| export GRAFANA_URL="http://grafana:3000"
export GRAFANA_API_KEY="your-api-key"
export MCP_AUTH_API_KEY="your-mcp-key"
./cloud-native-mcp-server
|
配置验证#
服务器在启动时验证配置。常见验证错误：
缺少必需字段#
Error: auth API key is required for apikey mode
无效的认证模式#
Error: invalid auth mode: invalid (must be apikey, bearer, or basic)
缺少服务地址#
Error: grafana URL is required when service is enabled
测试配置#
在不启动服务器的情况下测试配置：
1
2
| # 检查配置文件语法
./cloud-native-mcp-server --config=config.yaml --list=services --output=table
|
这将会：
- 解析配置文件
- 验证所有字段
- 检查服务连通性
- 报告任何错误
热重载#
不支持热重载。重启服务器以应用配置更改：
1
2
3
4
5
6
| # 发送 SIGTERM 以优雅关闭
kill -TERM <pid>
# 服务器将完成进行中的请求并退出
# 然后使用新配置启动
./cloud-native-mcp-server --config=new-config.yaml
|
相关文档#