What is Skywalking Mcp

Skywalking-MCP is an Apache SkyWalking MCP Server, which is part of the Apache SkyWalking project. It serves as an application performance monitoring (APM) system specifically designed for microservices, cloud-native, and container-based architectures such as Docker, Kubernetes, and Mesos.

Use cases

Use cases for Skywalking-MCP include monitoring microservices performance, diagnosing application issues in real-time, analyzing system metrics, and ensuring the reliability of cloud-native applications.

How to use

To use Skywalking-MCP, you can start by setting up the server according to the documentation provided in the Apache SkyWalking repository. Users can submit issues or questions via the project’s GitHub page or join the Apache Slack channel for community support.

Key features

Key features of Skywalking-MCP include monitoring of application performance, support for microservices and cloud-native architectures, real-time data analysis, and integration with various container orchestration platforms.

Where to use

Skywalking-MCP is used in environments that leverage microservices, cloud-native applications, and container technologies. It is particularly beneficial for organizations looking to monitor and optimize the performance of distributed systems.

Apache SkyWalking MCP

SkyWalking-MCP: A Model Context Protocol (MCP) server for integrating AI agents with Skywalking OAP and the surrounding ecosystem.

SkyWalking: an APM(application performance monitor) system, especially designed for
microservices, cloud native and container-based (Docker, Kubernetes, Mesos) architectures.

Usage

From Source

# Clone the repository
git clone https://github.com/apache/skywalking-mcp.git
cd skywalking-mcp && go mod tidy

# Build the project
make

Command-line Options

Usage:
  swmcp [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  sse         Start SSE server
  stdio       Start stdio server

Flags:
  -h, --help               help for swmcp
      --log-command        When true, log commands to the log file
      --log-file string    Path to log file
      --log-level string   Logging level (debug, info, warn, error) (default "info")
      --read-only          Restrict the server to read-only operations
      --sw-url string      Specify the OAP URL to connect to (e.g. http://localhost:12800)
  -v, --version            version for swmcp

Use "swmcp [command] --help" for more information about a command.

You could start the MCP server with the following command:

# use stdio server
bin/swmcp stdio --sw-url http://localhost:12800

# or use SSE server
bin/swmcp sse --sse-address localhost:8000 --base-path /mcp --sw-url http://localhost:12800

Usage with Cursor

{
  "mcpServers": {
    "skywalking": {
      "command": "swmcp stdio",
      "args": [
        "--sw-url",
        "http://localhost:12800"
      ]
    }
  }
}

If using Docker:

make build-image to build the Docker image, then configure the MCP server like this:

{
  "mcpServers": {
    "skywalking": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "SW_URL",
        "skywalking-mcp:latest"
      ],
      "env": {
        "SW_URL": "http://localhost:12800"
      }
    }
  }
}

Contact Us

• Submit an issue by using MCP as title prefix.
• Mail list: [email protected]. Mail to [email protected], follow the reply to subscribe the mail list.
• Join skywalking channel at Apache Slack. If the link is not working, find the latest one at Apache INFRA WIKI.
• Twitter, ASFSkyWalking

License

Apache 2.0 License.