Skip to content

chore: remove toolhive and mcpserver references#210

Merged
pdettori merged 1 commit intokagenti:mainfrom
Bobbins228:remove-toolhive-references
Mar 11, 2026
Merged

chore: remove toolhive and mcpserver references#210
pdettori merged 1 commit intokagenti:mainfrom
Bobbins228:remove-toolhive-references

Conversation

@Bobbins228
Copy link
Contributor

Summary

Removed toolhive and mcpserver CRD references in GETTING_STARTED.md

Related issue(s)

(Optional) Testing Instructions

Fixes #

@Bobbins228 Bobbins228 requested a review from a team as a code owner March 10, 2026 10:48
@Bobbins228 Bobbins228 force-pushed the remove-toolhive-references branch from 2c656c8 to f7d059a Compare March 10, 2026 10:53
@pdettori pdettori added the safe-to-test Maintainer reviewed - safe to run E2E tests label Mar 10, 2026
@cwiklik cwiklik self-requested a review March 10, 2026 13:19
Copy link
Collaborator

@cwiklik cwiklik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Clean removal of all ToolHive/MCPServer CRD references, replaced with standard Kubernetes Deployments. Thorough and consistent — no leftover toolhive mentions. Good security posture preserved in the Deployment spec (nonRoot, drop ALL, seccomp). Consistent kagenti.io/type=tool selectors throughout.

However, there are a few functional gaps in the documentation that should be addressed before merge.

Areas reviewed: Docs, YAML, Security
Commits: 1 (signed-off: yes)
CI status: all passing

Must-fix issues

1. Missing Service manifest — The doc shows a Deployment but no Service YAML, yet all examples reference weather-tool-mcp.team1.svc.cluster.local. A user following this guide step-by-step won't have a working Service. Either add a Service manifest or clarify what creates it (Kagenti operator auto-creates it?).

2. Phantom service account name — Troubleshooting references kubectl get serviceaccount weather-service but this name doesn't appear anywhere else in the doc. The Deployment YAML has no serviceAccountName field. Should this be weather-tool or removed entirely?

3. Grammar — "The reason this DNS name works is that Kubernetes Service is created" → "...is that a Kubernetes Service is created"

Suggestions

4. Verbose Deployment YAML — The YAML is ~80 lines with defaults users don't need to set (progressDeadlineSeconds, revisionHistoryLimit, terminationMessagePolicy, strategy block, etc.). For a getting-started guide, a minimal Deployment (~25 lines, letting K8s defaults handle the rest) would be friendlier.

5. Unexplained kagenti.io/inject: disabled label — This label is new but not explained. Users won't know what it controls or when to change it.

6. Inconsistent terminology — Alternates between "MCP server", "MCP Server Deployment", and "MCP Server resource". Since these are now plain Deployments (not CRDs), pick one consistent term.

app.kubernetes.io/name: weather-tool
kagenti.io/framework: Python
protocol.kagenti.io/streamable_http: ""
kagenti.io/inject: disabled
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion: kagenti.io/inject: disabled is a new label not present in the old MCPServer YAML. Users following a getting-started guide won't know what it controls or when they might want to change it. Consider adding a brief inline comment or note.

targetPort: 8000
proxyPort: 8000
podTemplateSpec:
progressDeadlineSeconds: 600
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion: This Deployment YAML looks like a kubectl get -o yaml dump rather than a minimal example. Fields like progressDeadlineSeconds: 600, revisionHistoryLimit: 10, terminationMessagePath, terminationMessagePolicy, dnsPolicy, schedulerName, and the full strategy block are all Kubernetes defaults that users don't need to set. For a getting-started guide, a minimal Deployment (~25 lines) would be much friendlier and less intimidating. The old MCPServer YAML was ~25 lines.

@Bobbins228 Bobbins228 force-pushed the remove-toolhive-references branch from f7d059a to 5aa8fa9 Compare March 10, 2026 16:19
Signed-off-by: Bobbins228 <mcampbel@redhat.com>
@Bobbins228 Bobbins228 force-pushed the remove-toolhive-references branch from 5aa8fa9 to 5409e05 Compare March 10, 2026 16:21
Copy link
Contributor

@pdettori pdettori left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

@pdettori pdettori merged commit bb24ef8 into kagenti:main Mar 11, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe-to-test Maintainer reviewed - safe to run E2E tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants