[Experimental idea] MCP integration for skywalking to insight data.

[CodePrometheus]

Since MCP became popular, I've had an idea to implement an MCP tool. I created a repository skywalking-mcp-experimental to quickly validate this idea.
Currently, it has only one capability - querying information based on traceID. The effect is shown in the image below. We could use natural language through AI tools to help analyze the data.

[wu-sheng]

MCP is in my mind, we could discuss deeper about the implementation and roadmap if you have a proposal.

[wu-sheng]

Do you plan to have a separate MCP server deployed and connect to OAP with GraphQL adaptor to query the metrics/traces/logs?

[kezhenxu94]

Do you plan to have a separate MCP server deployed and connect to OAP with GraphQL adaptor to query the metrics/traces/logs?

I think this is a common idea of building an MCP server for existing services. BTW @CodePrometheus , I see the PoC is written in nodejs, that’s totally ok for a PoC, but in case you don’t know, I’ve recently refactored the skywalking-cli repo so we can easily reuse all the query APIs using the Go module in https://github.com/apache/skywalking-cli/tree/master/pkg/graphql, and the remaining work would be wrapping these in an MCP framework like https://github.com/mark3labs/mcp-go

[wu-sheng]

With some ideas, powered by AI analysis, query and analysis profiling results would be helpful for end users as well.

[CodePrometheus]

I’ve recently refactored the skywalking-cli repo so we can easily reuse all the query APIs using the Go module in https://github.com/apache/skywalking-cli/tree/master/pkg/graphql

Woo! thanks for the info, it's really powerful and does everything we need.

[CodePrometheus]

TL;DR:
SkyWalking-MCP is designed to transform raw observability data(metrics, traces, logs, and more) into actionable insights with AI-powered analysis, leveraging LLMs, it enables natural language querying and deep analytics across BanyanDB and other observability data sources.

https://docs.google.com/document/d/1zig-V9oT-rOSdXm7prIC9v7mmnQ3a3wmzilPMg-d2U8/edit?tab=t.0#heading=h.llseg7j7tjyp

[wu-sheng]

I have commented some in the doc. Generally, this should be good.

[CodePrometheus]

Thanks!

1. For Dependency-Check, I ran it locally and the results are as follows:

Dependency Resolve Result (mcp-go version is [tags/v0.26.0])

license-eye -c .licenserc_for_test_check.yaml dep check

INFO Loading configuration from file: .licenserc_for_test_check.yaml

ERROR the following licenses are unknown or incompatible with the main license, please check manually:

Dependency	License
github.com/google/uuid	BSD-3-Clause
github.com/spf13/cast	MIT
github.com/stretchr/testify	MIT
github.com/yosida95/uritemplate/v3	BSD-3-Clause
github.com/davecgh/go-spew	ISC
github.com/pmezard/go-difflib	BSD-3-Clause
ERROR one or more errors occurred checking license compatibility

Let me add some licenses to solve the above problem.

2. I haven't yet tried directly connecting to BanyanDB for CRUD operations in the MCP server, I'll keep an eye on this particular aspect.

[wu-sheng]

Once the license check completed, I think I could create skywalking-mcp repo for this new thing.
What do you think for this repo name?

cc @apache/skywalking-committers

[CodePrometheus]

I'm +1 for it.

[wu-sheng]

I will create this repo today. Please finish the dependency check when you need to push codes there.
BTW, I wouldn't open branch protection for now, to make you easier to initialize the repo. Then we could make everything back to normal PR process flow.

[wu-sheng]

Repo created as requested. https://github.com/apache/skywalking-mcp

You could push the initial commit when you are ready.

[wu-sheng]

@CodePrometheus How does this thing go on your side?

[CodePrometheus]

Recently I've been continuously learning some practical about MCP Server and will complete a version during Dragon Boat Festival.