apache/skywalking-banyandb-mcp

Apache SkyWalking BanyanDB MCP镜像

Docker镜像并非ASF官方发布，而是为方便使用提供。推荐用法始终是从源码构建。

SkyWalking是一个APM（应用性能监控）系统，专为微服务、云原生和基于容器的架构设计。

BanyanDB MCP是BanyanDB的模型上下文协议（MCP）服务器。它帮助MCP兼容客户端使用BydbQL查询BanyanDB，并发现可用的组和模式。

此镜像连接到现有的BanyanDB实例，本身不运行BanyanDB。

源码和Dockerfile可在https://github.com/apache/skywalking-banyandb/tree/main/mcp/Dockerfile%E6%89%BE%E5%88%B0%E3%80%82

如何使用此镜像

使用默认stdio传输运行MCP服务器

此模式适用于将服务器作为子进程启动的桌面MCP客户端。

bash
docker run --rm -i \
  -e BANYANDB_ADDRESS=host.docker.internal:17900 \
  apache/skywalking-banyandb-mcp:latest

BANYANDB_ADDRESS默认为localhost:17900。当使用17900时，MCP服务器会自动与BanyanDB的***端口HTTP API通信。

如果BanyanDB在另一个容器中运行，在同一Docker网络上使用容器或服务名称代替host.docker.internal。

在HTTP模式下运行MCP服务器

此模式适用于支持Streamable HTTP的MCP客户端。

bash
docker run --rm -p 3000:3000 \
  -e TRANSPORT=http \
  -e MCP_PORT=3000 \
  -e BANYANDB_ADDRESS=host.docker.internal:17900 \
  apache/skywalking-banyandb-mcp:latest

MCP端点将在以下地址可用：

text
http://localhost:3000/mcp

MCP客户端配置示例

使用Docker的stdio模式：

json
{
  "mcpServers": {
    "banyandb": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "BANYANDB_ADDRESS=host.docker.internal:17900",
        "apache/skywalking-banyandb-mcp:latest"
      ]
    }
  }
}

使用HTTP模式：

json
{
  "mcpServers": {
    "banyandb": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

配置

镜像可通过以下环境变量进行配置：

• BANYANDB_ADDRESS：BanyanDB服务器地址。默认值：localhost:17900。
• TRANSPORT：传输方式，可选stdio或http。默认值：stdio。
• MCP_PORT：当TRANSPORT=http时的HTTP监听端口。默认值：3000。

了解更多

• 安装指南：https://github.com/apache/skywalking-banyandb/blob/main/docs/operation/mcp/setup.md
• 检查器指南：https://github.com/apache/skywalking-banyandb/blob/main/docs/operation/mcp/inspector.md
• 项目主页：[***]