apache/skywalking-mcp repository overview

⁠Apache SkyWalking MCP Image

Docker images are not official ASF releases but are provided for convenience. The recommended way to use Apache SkyWalking MCP in production-sensitive environments is to build from source and verify the published release artifacts.

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

SkyWalking MCP is a Model Context Protocol (MCP) server that connects AI agents to Apache SkyWalking OAP. It exposes SkyWalking observability data, including traces, logs, metrics, topology, alarms, and events, through MCP tools and prompts.

You can find the source code and Dockerfile here⁠

⁠How to use this image

This image starts the MCP server with the stdio transport by default.

Run the MCP server in stdio mode:

docker run --rm -i apache/skywalking-mcp:latest \
  --sw-url http://host.docker.internal:12800

Run the MCP server in sse mode:

docker run --rm -p 8000:8000 apache/skywalking-mcp:latest \
  sse \
  --sse-address 0.0.0.0:8000 \
  --base-path /mcp \
  --sw-url http://host.docker.internal:12800

If your SkyWalking OAP requires basic authentication:

docker run --rm -i apache/skywalking-mcp:latest \
  --sw-url http://host.docker.internal:12800 \
  --sw-username admin \
  --sw-password '${SW_PASSWORD}'

⁠Configuration

Common command-line flags:

• --sw-url: SkyWalking OAP address, for example http://localhost:12800
• --sw-username: Basic auth username for SkyWalking OAP
• --sw-password: Basic auth password for SkyWalking OAP, including ${ENV_VAR} syntax support
• --read-only: Restrict the MCP server to read-only operations
• --log-level: Log level, such as debug, info, warn, or error
• --log-file: Path to the log file

Available transports:

• stdio: Default mode for local MCP clients such as Cursor, Claude Code, and GitHub Copilot
• sse: HTTP Server-Sent Events transport
• streamable: Streamable HTTP transport

Please refer to the project README for complete usage and client configuration examples:

• https://github.com/apache/skywalking-mcp/blob/main/README.md⁠

⁠Contact Us

• Issue tracker: https://github.com/apache/skywalking/issues⁠
• Mailing list: [email protected]⁠
• Slack: http://s.apache.org/slack-invite⁠
• Website: https://skywalking.apache.org/⁠

⁠License

Apache 2.0