{"id":28613995,"url":"https://github.com/apache/skywalking-mcp","last_synced_at":"2025-10-04T10:48:31.622Z","repository":{"id":293920286,"uuid":"981584560","full_name":"apache/skywalking-mcp","owner":"apache","description":"Apache SkyWalking MCP Server","archived":false,"fork":false,"pushed_at":"2025-09-22T12:27:07.000Z","size":97,"stargazers_count":11,"open_issues_count":1,"forks_count":4,"subscribers_count":33,"default_branch":"main","last_synced_at":"2025-09-28T00:29:13.871Z","etag":null,"topics":["ai","apm","llm","mcp","observability","skywalking"],"latest_commit_sha":null,"homepage":"https://skywalking.apache.org/","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apache.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-11T12:51:01.000Z","updated_at":"2025-09-09T14:36:21.000Z","dependencies_parsed_at":"2025-05-18T00:14:57.525Z","dependency_job_id":"2f899dd3-9347-407f-944f-2b6d5b717f2f","html_url":"https://github.com/apache/skywalking-mcp","commit_stats":null,"previous_names":["apache/skywalking-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/apache/skywalking-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fskywalking-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fskywalking-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fskywalking-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fskywalking-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/skywalking-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fskywalking-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278302558,"owners_count":25964520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","apm","llm","mcp","observability","skywalking"],"created_at":"2025-06-12T01:10:42.199Z","updated_at":"2025-10-04T10:48:31.615Z","avatar_url":"https://github.com/apache.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"Apache SkyWalking MCP\n==========\n\n\u003cimg src=\"http://skywalking.apache.org/assets/logo.svg\" alt=\"Sky Walking logo\" height=\"90px\" align=\"right\" /\u003e\n\n**SkyWalking-MCP**: A [Model Context Protocol][mcp] (MCP) server for integrating AI agents with Skywalking OAP and the\nsurrounding ecosystem.\n\n**SkyWalking**: an APM(application performance monitor) system, especially designed for\nmicroservices, cloud native and container-based (Docker, Kubernetes, Mesos) architectures.\n\n## Usage\n\n### From Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/apache/skywalking-mcp.git\ncd skywalking-mcp \u0026\u0026 go mod tidy\n\n# Build the project\nmake\n```\n\n### Command-line Options\n\n```bash\nUsage:\n  swmcp [command]\n\nAvailable Commands:\n  completion  Generate the autocompletion script for the specified shell\n  help        Help about any command\n  sse         Start SSE server\n  stdio       Start stdio server\n  streamable  Start Streamable server\n\nFlags:\n  -h, --help               help for swmcp\n      --log-command        When true, log commands to the log file\n      --log-file string    Path to log file\n      --log-level string   Logging level (debug, info, warn, error) (default \"info\")\n      --read-only          Restrict the server to read-only operations\n      --sw-url string      Specify the OAP URL to connect to (e.g. http://localhost:12800)\n  -v, --version            version for swmcp\n\nUse \"swmcp [command] --help\" for more information about a command.\n```\n\nYou could start the MCP server with the following command:\n\n```bash\n# use stdio server\nbin/swmcp stdio --sw-url http://localhost:12800\n\n# or use SSE server\nbin/swmcp sse --sse-address localhost:8000 --base-path /mcp --sw-url http://localhost:12800\n```\n\n### Usage with Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"skywalking\": {\n      \"command\": \"swmcp stdio\",\n      \"args\": [\n        \"--sw-url\",\n        \"http://localhost:12800\"\n      ]\n    }\n  }\n}\n```\n\nIf using Docker:\n\n`make build-image` to build the Docker image, then configure the MCP server like this:\n\n```json\n{\n  \"mcpServers\": {\n    \"skywalking\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\",\n        \"SW_URL\",\n        \"skywalking-mcp:latest\"\n      ],\n      \"env\": {\n        \"SW_URL\": \"http://localhost:12800\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\nSkyWalking MCP provides the following tools to query and analyze SkyWalking OAP data:\n\n| Category    | Tool Name                | Description                            | Key Features                                                                                                                                                                                                                                                                  |\n|-------------|--------------------------|----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Trace**   | `get_trace_details`      | Get detailed trace information         | Retrieve trace by ID; **Multiple views**: `full` (complete trace), `summary` (overview with metrics), `errors_only` (error spans only); Detailed span analysis                                                                                                                |\n| **Trace**   | `get_cold_trace_details` | Get trace details from cold storage    | Query historical traces from BanyanDB; **Multiple views**: `full`, `summary`, `errors_only`; Duration-based search; Historical incident investigation                                                                                                                         |\n| **Trace**   | `query_traces`           | Query traces with intelligent analysis | Multi-condition filtering (service, endpoint, duration, state, tags); **Multiple views**: `full` (raw data), `summary` (intelligent analysis with performance insights), `errors_only` (error traces); Sort options; Slow trace detection; Performance metrics and statistics |\n| **Metrics** | `query_single_metrics`   | Query single metric values             | Get specific metric values (CPM, response time, SLA, Apdex); Multiple entity scopes (Service, ServiceInstance, Endpoint, Process, Relations); Time range and cold storage support                                                                                             |\n| **Metrics** | `query_top_n_metrics`    | Query top N metric rankings            | Rank entities by metric values; Configurable top N count; Ascending/descending order; Scope-based filtering; Performance analysis and issue identification                                                                                                                    |\n| **Log**     | `query_logs`             | Query logs from SkyWalking OAP         | Filter by service, instance, endpoint, trace ID, tags; Time range queries; Cold storage support; Pagination support                                                                                                                                                           |\n| **MQE**     | `execute_mqe_expression` | Execute MQE expressions for metrics    | Execute complex MQE (Metrics Query Expression) queries; Support calculations, aggregations, comparisons, TopN, trend analysis; Multiple result types (single value, time series, sorted list); Entity filtering and relation metrics; Debug and tracing capabilities          |\n| **MQE**     | `list_mqe_metrics`       | List available metrics for MQE         | Discover available metrics for MQE queries; Filter by regex patterns; Get metric metadata (type, catalog); Support service, instance, endpoint, relation, database, and infrastructure metrics                                                                                |\n| **MQE**     | `get_mqe_metric_type`    | Get metric type information            | Get detailed type information for specific metrics; Understand metric structure (regular value, labeled value, sampled record); Help with correct MQE expression syntax                                                                                                       |\n\n## Contact Us\n\n* Submit [an issue](https://github.com/apache/skywalking/issues/new) by using [MCP] as title prefix.\n* Mail list: **dev@skywalking.apache.org**. Mail to `dev-subscribe@skywalking.apache.org`, follow the reply to subscribe\n  the mail list.\n* Join `skywalking` channel at [Apache Slack](http://s.apache.org/slack-invite). If the link is not working, find the\n  latest one at [Apache INFRA WIKI](https://cwiki.apache.org/confluence/display/INFRA/Slack+Guest+Invites).\n* Twitter, [ASFSkyWalking](https://twitter.com/ASFSkyWalking)\n\n## License\n\n[Apache 2.0 License.](/LICENSE)\n\n[mcp]: https://modelcontextprotocol.io/","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fskywalking-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fskywalking-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fskywalking-mcp/lists"}