@wener/mcps

MCPs as a Service - 统一 MCP 服务代理。

一个进程托管多个 MCP 服务器，无需分别启动，支持预配置和动态配置。

快速开始

npx -y @wener/mcps@latest

在当前目录创建 .mcps.yaml：

servers:
  my-db:
    type: sql
    dbUrl: postgresql://user:pass@localhost/mydb

  metrics:
    type: prometheus
    url: http://prometheus:9090

  grafana:
    type: grafana
    url: http://grafana:3000
    serviceAccountToken: ${GRAFANA_SERVICE_ACCOUNT_TOKEN}
    orgId: 1
    timeoutMs: 60000

  logs:
    type: tencent-cls
    clientId: ${CLS_CLIENT_ID}
    clientSecret: ${CLS_CLIENT_SECRET}
    region: ap-shanghai

  upstream:
    type: relay
    url: http://other-mcp:8000

服务启动后：

• 预配置的 server 通过 /mcp/{name} 暴露
• 每个类型还暴露 /mcp/{type} 动态端点，通过请求头传入配置

内置 MCP 服务器

| 类型 | 端点 | 说明 | 动态 Header | |------|------|------|-------------| | sql | /mcp/sql | SQL 查询（MySQL、PostgreSQL、SQLite、MSSQL） | X-DB-URL, X-DB-READ-URL, X-DB-WRITE-URL | | prometheus | /mcp/prometheus | Prometheus 监控查询 | X-SERVICE-URL | | grafana | /mcp/grafana | Grafana dashboards / datasources / alerting / logs / Prometheus 查询 | X-GRAFANA-URL*, X-GRAFANA-SERVICE-ACCOUNT-TOKEN, X-GRAFANA-ORG-ID, X-GRAFANA-USERNAME, X-GRAFANA-PASSWORD | | tencent-cls | /mcp/tencent-cls | 腾讯云日志服务 | X-CLS-SECRET-ID*, X-CLS-SECRET-KEY*, X-CLS-REGION, X-CLS-ENDPOINT | | relay | /mcp/relay | 代理转发到其他 MCP 服务器 | X-MCP-URL*, X-MCP-TYPE |

* 为必填项

sql

servers:
  my-db:
    type: sql
    dbUrl: postgresql://user:pass@localhost/mydb
    # 支持读写分离
    # dbReadUrl: postgresql://reader@localhost/mydb
    # dbWriteUrl: postgresql://writer@localhost/mydb

prometheus

servers:
  metrics:
    type: prometheus
    url: http://prometheus:9090

grafana

Grafana 至少需要：

• url: Grafana 地址
• 一种认证方式：
  • serviceAccountToken
  • 或 username + password

常用可选项：

• orgId: 指定 Grafana org
• timeoutMs: Grafana 请求超时，毫秒
• headers: 额外透传给 Grafana 的自定义请求头

servers:
  grafana:
    type: grafana
    url: http://grafana:3000
    serviceAccountToken: ${GRAFANA_SERVICE_ACCOUNT_TOKEN}
    orgId: 1
    timeoutMs: 60000
    headers:
      X-Scope-OrgID: tenant-a

如果你不用 service account token，也可以走 basic auth：

servers:
  grafana:
    type: grafana
    url: http://grafana:3000
    username: admin
    password: ${GRAFANA_PASSWORD}
    orgId: 1

动态图配置示例：

curl http://localhost:8036/mcp/grafana \
  -H "X-GRAFANA-URL: http://grafana:3000" \
  -H "X-GRAFANA-SERVICE-ACCOUNT-TOKEN: $GRAFANA_SERVICE_ACCOUNT_TOKEN" \
  -H "X-GRAFANA-ORG-ID: 1" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

tencent-cls

servers:
  logs:
    type: tencent-cls
    clientId: ${CLS_SECRET_ID}
    clientSecret: ${CLS_SECRET_KEY}
    region: ap-shanghai        # 默认 ap-shanghai
    # endpoint: cls.tencentcloudapi.com

relay

servers:
  upstream:
    type: relay
    url: http://other-mcp:8000
    transport: http  # http | sse

动态配置

通过请求头传入配置，无需重启即可连接新的数据源：

curl http://localhost:8036/mcp/sql \
  -H "X-DB-URL: postgresql://user:pass@host/db" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

通用 Header

所有 MCP 端点支持以下请求头：

| Header | 说明 | |--------|------| | X-MCP-Readonly | 设为 true 仅返回只读工具 | | X-MCP-Include | 包含匹配的工具（glob，如 query_*） | | X-MCP-Exclude | 排除匹配的工具（glob，如 execute_*） |

配合 @wener/mcp-cli 使用时：

• mcp-cli query server/tool 只允许调用带 readOnlyHint: true 的工具
• mcp-cli call server/tool 才能调用写工具

例如：

MCP_CLI_CONFIG_INLINE='{"mcpServers":{"grafana":{"url":"http://127.0.0.1:8036/mcp/grafana"}},"include":["grafana"]}' \
  mcp-cli query grafana/query_prometheus '{"datasourceUid":"df3iuuyaa9tkwa","expr":"1","queryType":"instant","endTime":"now","stepSeconds":60}'

MCP_CLI_CONFIG_INLINE='{"mcpServers":{"grafana":{"url":"http://127.0.0.1:8036/mcp/grafana"}},"include":["grafana"]}' \
  mcp-cli query grafana/create_folder '{"title":"demo"}'

第二条会因为 create_folder 不是只读工具而被拒绝。

配置文件

按优先级从高到低（后者被前者覆盖）：

1. .mcps.local.yaml - 本地覆盖（建议 gitignore）
2. .mcps.yaml - 基础配置

支持 .yaml、.yml、.json 格式。配置值支持 ${VAR_NAME} 引用环境变量，自动加载 .env 和 .env.local。

servers:
  name:
    type: sql | prometheus | grafana | tencent-cls | relay
    disabled: false  # 可选，禁用该服务器
    # ... 各类型特定配置

audit:
  enabled: true       # 审计日志，默认开启
  db:
    path: .mcps.db    # SQLite 审计库路径

CLI

npx -y @wener/mcps@latest [options]

-p, --port <port>      端口号（默认 8036）
-c, --cwd <path>       配置文件目录