@vfarcic/dot-ai 0.167.0 β 0.169.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -95
- package/dist/interfaces/mcp.d.ts.map +1 -1
- package/dist/interfaces/mcp.js +7 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
# DevOps AI Toolkit
|
|
2
2
|
|
|
3
|
-
<!-- docs-exclude-start -->
|
|
4
3
|
<div align="center">
|
|
5
4
|
|
|
6
5
|
<p align="center">
|
|
@@ -16,116 +15,37 @@
|
|
|
16
15
|
[](https://github.com/vfarcic/dot-ai)
|
|
17
16
|
|
|
18
17
|
</div>
|
|
19
|
-
<!-- docs-exclude-end -->
|
|
20
18
|
|
|
21
19
|
**AI-powered platform engineering and DevOps automation through intelligent Kubernetes operations and conversational workflows.**
|
|
22
20
|
|
|
23
|
-
<!-- docs-exclude-start -->
|
|
24
|
-
π [Quick Start](./docs/quick-start.md) | π§ [MCP Setup](./docs/setup/mcp-setup.md) | π οΈ [Features & Tools](./docs/guides/mcp-tools-overview.md)
|
|
25
|
-
<!-- docs-exclude-end -->
|
|
26
21
|
---
|
|
27
22
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubernetes operations, and development workflows. It provides intelligent Kubernetes deployment recommendations through capability discovery and semantic matching, AI-powered issue remediation, automated repository setup with governance and security files, and shared prompt libraries for consistent development workflowsβall through natural language conversation.
|
|
31
|
-
|
|
32
|
-
Built on the Model Context Protocol (MCP), it integrates seamlessly with Claude Code, Cursor, and VS Code to provide conversational interaction for complex DevOps and development tasks.
|
|
33
|
-
|
|
34
|
-

|
|
35
|
-
|
|
36
|
-
## Mission
|
|
37
|
-
|
|
38
|
-
DevOps AI Toolkit democratizes platform engineering and cloud native operations by making complex workflows accessible through AI-powered automation. We eliminate the expertise barrier that prevents teams from adopting best practices in Kubernetes operations, repository governance, and standardized development workflowsβmaking professional-grade DevOps accessible through natural language interaction.
|
|
39
|
-
|
|
40
|
-
## Who Should Use This?
|
|
41
|
-
|
|
42
|
-
**DevOps AI Toolkit is for teams who want to**:
|
|
43
|
-
- Manage cloud resources (AWS, Azure, GCP) using Kubernetes as a control plane (developers, platform engineers)
|
|
44
|
-
- Quickly diagnose and fix cluster and infrastructure issues (SREs, DevOps engineers)
|
|
45
|
-
- Standardize resource provisioning with organizational patterns and policies (security engineers, platform teams)
|
|
46
|
-
- Bootstrap repositories with governance and security files (project maintainers)
|
|
47
|
-
- Access curated development prompts through native slash commands (development teams)
|
|
48
|
-
|
|
49
|
-
## Scope
|
|
50
|
-
|
|
51
|
-
### In Scope
|
|
52
|
-
- AI-powered resource provisioning recommendations using Kubernetes as control plane
|
|
53
|
-
- Intelligent issue remediation and root cause analysis
|
|
54
|
-
- Organizational pattern and policy management with semantic search
|
|
55
|
-
- MCP-based integration with AI coding assistants
|
|
56
|
-
- Multi-provider AI model support (Claude, GPT, Gemini)
|
|
57
|
-
- Project setup with governance, legal, and security files
|
|
58
|
-
|
|
59
|
-
### Out of Scope
|
|
60
|
-
- Kubernetes cluster provisioning/management (delegates to existing tools)
|
|
61
|
-
- CI/CD pipeline execution (provides recommendations only)
|
|
62
|
-
- Application runtime monitoring (integrates with existing observability tools)
|
|
63
|
-
|
|
64
|
-
## Key Features
|
|
65
|
-
|
|
66
|
-
### π Resource Provisioning Intelligence
|
|
67
|
-
Automatically discovers cluster resources using semantic capability management. AI understands what each resource actually does, providing intelligent recommendations for provisioning resources across clouds using Kubernetes as a control plane. When no matching capability exists, automatically discovers and installs third-party tools (Prometheus, Argo CD, Crossplane, etc.) via Helm charts from ArtifactHub.
|
|
68
|
-
π [Deployment Guide](./docs/guides/mcp-recommendation-guide.md) | [Capability Management](./docs/guides/mcp-capability-management-guide.md)
|
|
69
|
-
|
|
70
|
-
### π οΈ Issue Remediation
|
|
71
|
-
AI-powered root cause analysis with multi-step investigation, executable remediation commands, and safety mechanisms for manual or automatic execution.
|
|
72
|
-
π [Learn more β](./docs/guides/mcp-remediate-guide.md)
|
|
73
|
-
|
|
74
|
-
### ποΈ Pattern & Policy Management
|
|
75
|
-
Capture organizational knowledge and governance policies that automatically enhance AI recommendations with best practices and compliance requirements. Uses vector search for intelligent semantic matching.
|
|
76
|
-
π [Pattern Management](./docs/guides/pattern-management-guide.md) | [Policy Management](./docs/guides/policy-management-guide.md)
|
|
77
|
-
|
|
78
|
-
### π¦ Project Setup & Governance
|
|
79
|
-
Generate 25+ governance, legal, and automation files (LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, GitHub workflows, Renovate, OpenSSF Scorecard) for repository standardization.
|
|
80
|
-
π [Learn more β](./docs/guides/mcp-project-setup-guide.md)
|
|
81
|
-
|
|
82
|
-
### π¬ Shared Prompts Library
|
|
83
|
-
Access curated prompts as native slash commands (`/dot-ai:prompt-name`) in your coding agent for consistent workflows across projects:
|
|
84
|
-
- **PRD Management**: Create, track, and complete Product Requirements Documents (`prd-create`, `prd-next`, `prd-done`, etc.)
|
|
85
|
-
- **Dockerfile Generation**: Generate production-ready, secure multi-stage Dockerfiles for any project (`generate-dockerfile`)
|
|
86
|
-
- **CI/CD Generation**: Generate intelligent CI/CD workflows through interactive conversation (`generate-cicd`)
|
|
87
|
-
|
|
88
|
-
π [Learn more β](./docs/guides/mcp-prompts-guide.md)
|
|
23
|
+
<div align="center">
|
|
89
24
|
|
|
90
|
-
|
|
91
|
-
Works with Claude Code, Cursor, VS Code via Model Context Protocol. Supports multiple AI providers (Claude, GPT, Gemini, Host LLM) for flexibility and cost optimization.
|
|
92
|
-
π [AI Model Configuration](./docs/setup/mcp-setup.md#ai-model-configuration)
|
|
25
|
+
## [Read the Documentation](https://devopstoolkit.ai/docs/mcp/)
|
|
93
26
|
|
|
94
|
-
|
|
27
|
+
</div>
|
|
95
28
|
|
|
96
|
-
|
|
97
|
-
1. Configure MCP server (Docker or npm)
|
|
98
|
-
2. Connect your AI coding assistant (Claude Code, Cursor, VS Code)
|
|
99
|
-
3. Start using conversational workflows
|
|
29
|
+
---
|
|
100
30
|
|
|
101
|
-
##
|
|
31
|
+
## Overview
|
|
102
32
|
|
|
103
|
-
|
|
104
|
-
- **[Quick Start Guide](docs/quick-start.md)** - Get started in minutes
|
|
105
|
-
- **[MCP Setup Guide](docs/setup/mcp-setup.md)** - Complete configuration instructions
|
|
106
|
-
- **[Tools Overview](docs/guides/mcp-tools-overview.md)** - All available tools and features
|
|
33
|
+
DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubernetes operations, and development workflows. Built on the Model Context Protocol (MCP), it integrates seamlessly with Claude Code, Cursor, and VS Code.
|
|
107
34
|
|
|
108
|
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
-
|
|
35
|
+
**Key capabilities:**
|
|
36
|
+
- Intelligent Kubernetes deployment recommendations
|
|
37
|
+
- AI-powered issue remediation and root cause analysis
|
|
38
|
+
- Organizational pattern and policy management
|
|
39
|
+
- Automated repository setup with governance files
|
|
40
|
+
- Shared prompt libraries for consistent workflows
|
|
113
41
|
|
|
114
|
-
|
|
115
|
-
- **[Resource Provisioning](docs/guides/mcp-recommendation-guide.md)** - AI-powered deployment recommendations
|
|
116
|
-
- **[Capability Management](docs/guides/mcp-capability-management-guide.md)** - Semantic resource discovery
|
|
117
|
-
- **[Issue Remediation](docs/guides/mcp-remediate-guide.md)** - AI-powered troubleshooting
|
|
118
|
-
- **[Pattern Management](docs/guides/pattern-management-guide.md)** - Organizational deployment patterns
|
|
119
|
-
- **[Policy Management](docs/guides/policy-management-guide.md)** - Governance and compliance
|
|
120
|
-
- **[Project Setup](docs/guides/mcp-project-setup-guide.md)** - Repository governance automation
|
|
42
|
+
[Read the Documentation](https://devopstoolkit.ai/docs/mcp/)
|
|
121
43
|
|
|
122
|
-
<!-- docs-exclude-start -->
|
|
123
44
|
## Support
|
|
124
45
|
|
|
125
46
|
- **[Support Guide](SUPPORT.md)** - How to get help and where to ask questions
|
|
126
47
|
- **GitHub Issues**: [Bug reports and feature requests](https://github.com/vfarcic/dot-ai/issues)
|
|
127
48
|
- **GitHub Discussions**: [Community Q&A and discussions](https://github.com/vfarcic/dot-ai/discussions)
|
|
128
|
-
- **Troubleshooting**: See [Troubleshooting Guide](./docs/setup/mcp-setup.md#troubleshooting) for common problems
|
|
129
49
|
|
|
130
50
|
## Contributing & Governance
|
|
131
51
|
|
|
@@ -142,7 +62,7 @@ We welcome contributions from the community! Please review:
|
|
|
142
62
|
|
|
143
63
|
Your feedback shapes dot-ai's future! After using the tools, you may occasionally see a feedback prompt - we'd love to hear what's working and what could be better.
|
|
144
64
|
|
|
145
|
-
|
|
65
|
+
[Share your feedback](https://forms.gle/dJcDXtsxhCCwgxtT6)
|
|
146
66
|
|
|
147
67
|
## License
|
|
148
68
|
|
|
@@ -155,7 +75,6 @@ DevOps AI Toolkit is built on:
|
|
|
155
75
|
- [Vercel AI SDK](https://sdk.vercel.ai/) for unified AI provider interface
|
|
156
76
|
- [Kubernetes](https://kubernetes.io/) for the cloud native foundation
|
|
157
77
|
- [CNCF](https://www.cncf.io/) for the cloud native ecosystem
|
|
158
|
-
<!-- docs-exclude-end -->
|
|
159
78
|
|
|
160
79
|
---
|
|
161
80
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAkDtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAyCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,qBAAqB;YAgBf,qBAAqB;IAyBnC,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;
|
|
1
|
+
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAkDtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAyCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,qBAAqB;YAgBf,qBAAqB;IAyBnC,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YA+HlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}
|
package/dist/interfaces/mcp.js
CHANGED
|
@@ -264,6 +264,13 @@ class MCPServer {
|
|
|
264
264
|
endSpan(204);
|
|
265
265
|
return;
|
|
266
266
|
}
|
|
267
|
+
// Health check endpoint (unauthenticated, for Kubernetes probes)
|
|
268
|
+
if (req.url === '/healthz' && req.method === 'GET') {
|
|
269
|
+
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
270
|
+
res.end(JSON.stringify({ status: 'ok' }));
|
|
271
|
+
endSpan(200);
|
|
272
|
+
return;
|
|
273
|
+
}
|
|
267
274
|
// Check Bearer token authentication (only when DOT_AI_AUTH_TOKEN is set)
|
|
268
275
|
// Skip authentication for OpenAPI specification endpoint (public documentation)
|
|
269
276
|
const isOpenApiEndpoint = req.url?.startsWith('/api/v1/openapi');
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vfarcic/dot-ai",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.169.0",
|
|
4
4
|
"description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
|
|
5
5
|
"mcpName": "io.github.vfarcic/dot-ai",
|
|
6
6
|
"main": "dist/index.js",
|