apache/skywalking-banyandb-mcp repository overview

⁠Apache SkyWalking BanyanDB MCP image

Docker images are not official ASF releases but provided for convenience. Recommended usage is always to build the source.

SkyWalking is an APM (application performance monitor) system designed for microservices, cloud native, and container-based architectures.

BanyanDB MCP is a Model Context Protocol (MCP) server for BanyanDB. It helps MCP-compatible clients query BanyanDB with BydbQL and discover available groups and schemas.

This image connects to an existing BanyanDB instance. It does not run BanyanDB by itself.

You can find the source code and Dockerfile here⁠

⁠How to use this image

⁠Run the MCP server with the default stdio transport.

This mode is suitable for desktop MCP clients that launch the server as a subprocess.

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

BANYANDB_ADDRESS defaults to localhost:17900. When 17900 is used, the MCP server automatically talks to BanyanDB's HTTP API on port 17913.

If BanyanDB is running in another container, use the container or service name on the same Docker network instead of host.docker.internal.

⁠Run the MCP server in HTTP mode

This mode is suitable for MCP clients that support Streamable HTTP.

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

The MCP endpoint will be available at:

http://localhost:3000/mcp

⁠Example MCP client configuration

Using Docker in stdio mode:

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

Using HTTP mode:

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

⁠Configuration

The image can be configured with these environment variables:

• BANYANDB_ADDRESS: BanyanDB server address. Default: localhost:17900.
• TRANSPORT: stdio or http. Default: stdio.
• MCP_PORT: HTTP listen port when TRANSPORT=http. Default: 3000.

⁠Learn more

• Setup guide: https://github.com/apache/skywalking-banyandb/blob/main/docs/operation/mcp/setup.md⁠
• Inspector guide: https://github.com/apache/skywalking-banyandb/blob/main/docs/operation/mcp/inspector.md⁠
• Project homepage: https://skywalking.apache.org/⁠