Skip to content

Commit 27b3a82

Browse files
committed
Add Model Context Protocol (MCP) project proposal
Signed-off-by: Pavol Loffay <p.loffay@gmail.com>
1 parent 887d44a commit 27b3a82

File tree

2 files changed

+142
-0
lines changed

2 files changed

+142
-0
lines changed

.cspell.yaml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,11 @@ ignoreRegExpList:
1818
- GitHub Handle in YML
1919
words:
2020
- Abinet
21+
- agentic
2122
- Alff
2223
- Arize
2324
- Ashpole
25+
- austinlparker
2426
- automations
2527
- Baeyens
2628
- calendar-localization-ptbr
@@ -186,6 +188,7 @@ words:
186188
- mjwolf
187189
- mkorbi
188190
- molkova
191+
- mottibec
189192
- msomasu
190193
- MSYS
191194
- PATHCONV
@@ -208,6 +211,7 @@ words:
208211
- opentelemetrybot
209212
- ossf
210213
- otel
214+
- otelcol
211215
- otel-agentmanwg
212216
- otel-comms
213217
- otel-ebpf
@@ -222,6 +226,7 @@ words:
222226
- Prometheus
223227
- paixão
224228
- pająk
229+
- pavolloffay
225230
- passcodes
226231
- poncelow
227232
- proto
@@ -247,6 +252,7 @@ words:
247252
- severin
248253
- sguyon
249254
- sharma
255+
- shiftyp
250256
- shkuro
251257
- sigelman
252258
- signup

projects/mcp-server.md

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
# OpenTelemetry Collector Model Context Protocol (MCP) Server
2+
3+
## Background and description
4+
5+
The OpenTelemetry project consists of a large number of components, including collector, SDKs, and instrumentation libraries, which are often configured and managed separately. This distribution of components poses a major operational challenge which is universally recognized by the community [1], [2].
6+
7+
Large language models (LLMs), present a significant opportunity to simplify the adoption, implementation, and management of the OpenTelemetry stack. An AI agent could, for example, analyze telemetry data, facilitate configuration changes, or assist and simplify the instrumentation process.
8+
9+
However, to support this process, a standardized interface is required for LLMs to interact with the OpenTelemetry ecosystem. The Model Context Protocol (MCP) provides an idiomatic approach for this interaction.
10+
11+
At the moment, the OpenTelemetry project does not have an official, standard MCP server. This has led to the creation of several independent, open-source projects to fill the gap.
12+
13+
### Existing OpenTelemetry MCP Servers
14+
15+
The proliferation of these projects demonstrates strong community interest and the clear potential of this technology:
16+
17+
* [pavolloffay/opentelemetry-mcp-server](https://github.com/pavolloffay/opentelemetry-mcp-server): Focuses on collector configuration.
18+
* [austinlparker/otel-mcp](https://github.com/austinlparker/otel-mcp): Handles collector configuration and data profiling.
19+
* [mottibec/otelcol-mcp](https://github.com/mottibec/otelcol-mcp): Focuses on collector configuration.
20+
* [shiftyp/otel-mcp-server](https://github.com/shiftyp/otel-mcp-server): Provides data profiling, but requires OpenSearch.
21+
* [liatrio-labs/otel-instrumentation-mcp](https://github.com/liatrio-labs/otel-instrumentation-mcp): Manages instrumentation.
22+
* [traceloop/opentelemetry-mcp-server](https://github.com/traceloop/opentelemetry-mcp-server): Provides data profiling by connecting to Jaeger, Tempo and Traceloop.
23+
24+
Each of these servers uses a different approach, particularly for collector configuration and data profiling.
25+
This fragmentation creates confusion for users in terms of installation and configuration. It is less effective
26+
as multiple competing tools fill up context window and provide overlapping functionality.
27+
28+
### Project Scope and Architecture
29+
30+
The scope of this project is to create OpenTelemetry MCP server(s) to simplify deployment and day-2 operations.
31+
The MCP server should also provide data profiling/intelligence capabilities to support the day-2 operation use-cases.
32+
33+
### Goals, objectives, and requirements
34+
35+
The goals are divided into categories. However, some common goals apply to all created MCP(s):
36+
37+
* A common installation and configuration
38+
39+
#### Collector
40+
41+
* Deployment, configuration and management
42+
* Simplify writing OpenTelemetry Transformation Language (OTTL)
43+
* Simplify writing PII rules based on the received data
44+
45+
#### Instrumentation
46+
47+
* SDK configuration
48+
* Auto-instrumentation configuration
49+
* Identify instrumentation issues: single span traces, broken traces, high cardinality attributes
50+
51+
#### Semantic conventions
52+
53+
* Weaver schema generation
54+
* Context optimized querying of the official semantic conventions registry
55+
56+
## Deliverables
57+
58+
* Collector MCP server
59+
* Configuration use-cases
60+
* Data profiling use-cases: writing PII rules, high cardinality attributes, broken traces, single span traces
61+
* Standalone MCP Server
62+
* Instrumentation use-cases
63+
* Collector provisioning and configuration use-cases
64+
* Understanding changes in released artifacts
65+
66+
## Staffing / Help Wanted
67+
68+
This project requires a blend of OpenTelemetry collector, documentation and instrumentation expertise and expertise in building MCP server(s).
69+
70+
### SIG
71+
72+
This project will be led by a cross-cutting effort coordinating with the Collector, documentation, and language SIGs.
73+
74+
This effort will be hosted in the existing Developer Experience SIG.
75+
76+
### Required staffing
77+
78+
#### Project Leads(s)
79+
80+
* [@pavolloffay](https://github.com/pavolloffay) (Red Hat)
81+
* [@niwoerner](https://github.com/niwoerner) (OllyGarden)
82+
83+
#### TC Sponsor
84+
85+
Not needed.
86+
87+
#### GC Liaison
88+
89+
* [@austinlparker](https://github.com/austinlparker) (Austin Parker - Honeycomb) - existing SIG developer experience liaison.
90+
91+
#### Engineers
92+
93+
* [@adrielp](https://github.com/adrielp)
94+
* [@shiftyp](https://github.com/shiftyp)
95+
96+
#### Other Staffing
97+
98+
### Industry outreach (Optional)
99+
100+
The following users have built OpenTelemetry MCP servers:
101+
102+
* [otel-mcp](https://github.com/austinlparker) - author of [otel-mcp](https://github.com/austinlparker/otel-mcp)
103+
* [mottibec](https://github.com/mottibec) - author of [otelcol-mcp](https://github.com/mottibec/otelcol-mcp)
104+
* [shiftyp](https://github.com/shiftyp) - author of [otel-mcp-server](https://github.com/shiftyp/otel-mcp-server)
105+
106+
There will be [OpenTelemetry MCP blog post](https://github.com/open-telemetry/opentelemetry.io/pull/8331/) which promote the SIG.
107+
108+
## Expected Timeline
109+
110+
This timeline assumes project approval and resource allocation as outlined in the staffing section. Until staffing is
111+
confirmed and expected time commitments are known, this timeline is in flux.
112+
113+
Phase 1: Static collector configuration (Months 1-2)
114+
- OpenTelemetry collector configuration
115+
116+
Phase 2: Data profiling via collector (Months 1-2)
117+
- OpenTelemetry collector extension which provides API to query and profile the processed telemetry data
118+
- Data volume attribution
119+
120+
Phase 3: Instrumentation (Months 1-2)
121+
- Identify broken traces
122+
- Identify single span traces
123+
- Identify high cardinality traces
124+
- Instrumentation configuration
125+
126+
## Labels
127+
128+
`mcp` for all PRs and issues related to this project.
129+
130+
## GitHub Project (Post-Approval)
131+
132+
TBD
133+
134+
## SIG Meetings, Roadmap, and Other Info (Post-Approval)
135+
136+
[Developer Experience SIG](https://github.com/open-telemetry/community?tab=readme-ov-file#sig-devex)

0 commit comments

Comments
 (0)