Provides tools for inspecting Kubernetes clusters managed by k3s, including getting resources, describing resources, reading container logs, viewing events, and checking node and pod status and resource usage.
Provides read-only access to TrueNAS Scale system information, applications, and pools via whitelisted midclt calls, enabling AI assistants to query TrueNAS configuration and status.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@truenas-mcp Show me the pod status summary for all namespaces"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Read-only MCP server for TrueNAS Scale debugging. Runs directly on TrueNAS and provides:
k3s tools — kubectl get/describe/logs/events/top wrapped as MCP tools
TrueNAS API — whitelisted midclt call methods for system info, apps, pools
No destructive operations. Every tool is read-only.
# Install
pip install git+https://github.com/a-simple-test-organization/truenas-mcp.git
# Run (no auth)
MCP_PORT=38888 python -m truenas_mcp.server
# Starts on http://0.0.0.0:38888/mcp
# Health check
curl http://localhost:38888/health
# → {"status": "ok", "auth_enabled": false}Related MCP server: Kubernetes Tools MCP Server
Set MCP_TOKEN to enable Bearer token auth. Then all requests must include Authorization: Bearer <token>.
# Generate a token
openssl rand -hex 32
# Run with auth
MCP_TOKEN="your-token-here" MCP_PORT=38888 python -m truenas_mcp.serverClient configuration (e.g. OpenClaw, Claude Code, OpenCode):
{
"mcpServers": {
"truenas": {
"url": "http://192.168.2.48:38888/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}The /health endpoint is always available without authentication.
# Copy the unit file
cp deploy/truenas-mcp.service /etc/systemd/system/
# Edit Environment=MCP_TOKEN= to set your token
vim /etc/systemd/system/truenas-mcp.service
# Enable and start
systemctl daemon-reload
systemctl enable --now truenas-mcp.service
# Check
systemctl status truenas-mcp
journalctl -u truenas-mcp -fTool | Description |
| Get resources (pods, deployments, nodes, ...) |
| Detailed resource description |
| Container logs |
| Cluster events |
| Node status |
| Resource usage by pod |
| Resource usage by node |
| Available API types |
| Quick all-pods overview |
Tool | Description |
| Call whitelisted TrueNAS API method |
| Call with arguments |
1. pod_status_summary
2. kubectl_events(all_namespaces=True)
3. kubectl_describe(resource_type="pod", name="<slow-pod>", namespace="ix-<app>")
4. kubectl_logs(pod_name="<slow-pod>", namespace="ix-<app>")
5. midclt_call(method="chart.release.query")Variable | Default | Description |
| auto (PATH + fallbacks) | Path to k3s binary |
| auto (PATH + fallbacks) | Path to midclt binary |
|
| HTTP listen port |
|
| HTTP listen host |
|
| Streamable HTTP endpoint path |
| (empty = no auth) | Bearer token for authentication |
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
The official MCP Server from Mia-Platform to interact with Mia-Platform Console
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/a-simple-test-organization/truenas-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server