[CNCF LFX Proposal] Meshery MCP Server

### CNCF Project

Meshery

### Term

2026 Term 3 (Sep-Nov)

### Program Name

MCP Server

### Program Description

## Description

Meshery manages cloud and cloud native infrastructure through Designs, Models, Connections, and a live topology continuously discovered by MeshSync. All of it is reachable over Meshery's REST and GraphQL APIs. None of it is reachable by an AI assistant. An engineer working with Claude, Copilot, or Cursor today copies YAML back and forth by hand, because the agent has no way to list designs, inspect a cluster, resolve a component schema, or deploy a pattern. The `meshery-mcp-server` repository was created to close that gap and is currently scaffolding only: a Makefile, lint configuration, and governance files, with no Go module, no protocol implementation, and no tools.

This project builds the server end to end. The mentee implements the Model Context Protocol foundation over both stdio and streamable HTTP transports, a Go client wrapping Meshery's REST and GraphQL APIs, and the tool, resource, and prompt surfaces that let an agent do real work: design lifecycle operations, Kubernetes cluster connection management, registry and model queries, environment and workspace management, and Nighthawk-backed performance testing. Read-only resources built on MeshSync-discovered topology ground the agent in what is actually running rather than only in what the schema permits, under hard constraints of no mutations and no secret exposure. Configuration supports multiple named Meshery instances with context switching, and the work ships as a real release: unit, integration, and end-to-end tests, CI, multi-platform binaries and a container image, and a quick start that takes a new user from zero to a working integration in under ten minutes.

## Expected Outcomes

- A released `meshery-mcp-server` binary and container image supporting stdio and streamable HTTP transports, verified against at least two MCP clients.
- Tool coverage across designs, clusters, registry and models, environments and workspaces, and performance tests, each with validated input schemas and structured error handling.
- Read-only MCP resources exposing MeshSync topology and Meshery Relationships, with enforced guarantees of no mutations and no secret exposure.
- MCP prompt templates for guided workflows: deploy an application, investigate cluster health, review a design against best practices, and configure a performance test.
- CI/CD with multi-platform release automation, at least 80% unit coverage on internal packages, and a published user guide, configuration reference, and AI client integration examples.

### Technologies

Golang, Model Context Protocol, REST, GitHub Actions

### Skills same as Technologies?

- [ ] Yes, the required skills are the same as the technologies listed above.

### Required/Desirable Skills

Kubernetes

### Mentors

Lee Calcote | @leecalcote | leecalcote@gmail.com | leecalcote
Yi Nuo | @yi-nuo426 | yinuo084@gmail.com| yinuo

### Upstream Issue URL

https://github.com/meshery/meshery/issues/19446

### Application Prerequisites

- [ ] Resume
- [ ] Cover Letter
- [ ] School Enrollment Verification
- [ ] Participation Permission from school or employer
- [ ] Coding Challenge
- [x] Custom Prerequisite (fill in details below)

### Coding Challenge URL

_No response_

### Custom Prerequisite Name

Participation is Key

### Custom Prerequisite Description

1. Join the community (https://slack.meshery.io).
2. Join the weekly newcomers meeting (https://meet.meshery.io) and learn about the project.
3. Get a feel for Meshery's capabilities in the Playground (https://play.meshery.io)
1. Create a design.
2. Receive a badge (from https://meshery.io/community/recognition/).
Optionally:
1. Add badge to your GitHub profile.
2. Publish your design the Catalog.
4. Ascertain whether your passions and skills align.

### Custom Prerequisite — File Upload

- [ ] Yes — completion of this task requires the mentee to submit a file.

---
**LFX program:** [CNCF - Meshery: MCP Server (2026 Term 3)](https://mentorship.lfx.linuxfoundation.org/project/29b6958b-77df-4135-85b2-f4a3185c1155)

Start by reading the existing Makefile, lint configuration, and governance files in the scaffolding-only meshery-mcp-server repository, then review the linked upstream Meshery issue. The work is complete when the server, API-backed tools and resources, transports, tests, CI, release artifacts, and user documentation described in this proposal are delivered.

Written by the indexing model from the issue text.