Skip to content

Commit 771fcdf

Browse files
ukjaiswalUttam Jaiswal
andauthored
chore: Update server.json to v1.4.0 for MCP Registry (#3)
* chore: Update server.json to version 1.4.0 for MCP Registry publication * docs: Update README heading from personal to professional * docs: Update README with MCP Registry publication status and v1.4.0 * docs: Add 'Why This MCP Server?' section highlighting unique value proposition * docs: Refine value proposition - focus on DevOps R&D and factual positioning * docs: Emphasize primary value - solving CLAUDE.md bloat problem * docs: Refine tagline to emphasize eliminating repeated instructions across projects and folders * docs: Add structured guidance appeal - TRACKER, ISSUES, docs, SoPs templates * docs: Clarify purpose - productivity framework, not knowledge base * docs: Specify target audience - Claude Code users building PoCs * docs: Add MCP verification steps and enhanced troubleshooting Added comprehensive verification and troubleshooting documentation: Manual Installation: - Added Step 5: Verify MCP Connection with test prompts - Tips for when Claude doesn't respond to MCP queries - Explicit reminders to help Claude check MCP servers Troubleshooting Section: - Enhanced "Claude Can't Access MCP Server" with detailed symptoms - 6-step solution guide including log checking - Pro tip: Claude sometimes "forgets" to check MCP servers - Documented log location: ~/.cache/claude/mcp-devops-practices.log Also includes previous fixes: - Repository URL replacements (GitHub) - GitLab → GitHub platform corrections - Installation method reordering (git clone first) - Team collaboration benefits - Value proposition clarity (structure not knowledge) * chore: Update version to 1.4.0 and fix consistency issues Version Updates (all to 1.4.0): - mcp-server.py serverInfo version - README.md, CONTRIBUTING.md, QUICK-START.md - CHANGELOG.md, PRACTICE-INDEX.md - .claude/instructions.md Date Updates (all to 2026-02-20): - Last Updated fields in all main documentation files GitLab Platform References Fixed: - QUICK-START.md: .gitlab-ci.yml → .github/workflows/ci.yml - QUICK-START.md: "GitLab CI/CD pipeline" → "GitHub Actions pipeline" - practices/02-01-git-practices.md: Updated automation example to GitHub Actions - src/devops_practices_mcp/practices/02-01-git-practices.md: Same fix Note: "GitLab Flow" references retained (branching strategy name) Note: Historical references in CHANGELOG.md and JOURNEY.md retained --------- Co-authored-by: Uttam Jaiswal <uttam.jaiswal@skill-mine.com>
1 parent 34ca572 commit 771fcdf

10 files changed

Lines changed: 287 additions & 95 deletions

File tree

.claude/instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -246,5 +246,5 @@ Examples should work across:
246246

247247
---
248248

249-
**Last Updated**: 2026-02-18
249+
**Last Updated**: 2026-02-20
250250
**Purpose**: Guide Claude when working on the MCP server repository and client projects

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -813,4 +813,4 @@ Initial release with core DevOps practices extracted from multiple infrastructur
813813

814814
**Maintainer:** Uttam Jaiswal
815815
**Repository:** devops-practices-mcp
816-
**Last Updated:** 2026-02-17
816+
**Last Updated:** 2026-02-20

CONTRIBUTING.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Thank you for contributing! This guide will help you understand our workflow and
2121

2222
```bash
2323
# Clone repository to the recommended location
24-
git clone <repo-url> ~/.mcp-servers/devops-practices
24+
git clone https://github.com/ai-4-devops/devops-practices.git ~/.mcp-servers/devops-practices
2525
cd ~/.mcp-servers/devops-practices
2626

2727
# Install dependencies (using modern tooling - recommended)
@@ -144,8 +144,8 @@ git push origin feature/add-security-practice
144144

145145
**4. Create Merge Request**
146146

147-
- Go to GitLab
148-
- Create MR: `feature/add-security-practice``develop`
147+
- Go to GitHub
148+
- Create PR: `feature/add-security-practice``develop`
149149
- Wait for CI/CD pipeline to pass
150150
- Request code review
151151
- Address feedback if needed
@@ -154,7 +154,7 @@ git push origin feature/add-security-practice
154154
**5. Cleanup**
155155

156156
```bash
157-
# After MR is merged
157+
# After PR is merged
158158
git checkout develop
159159
git pull origin develop
160160

@@ -190,7 +190,7 @@ git checkout develop
190190
git pull origin develop
191191
git checkout -b feature/fix-template-typo
192192

193-
# Fix, commit, create MR → develop
193+
# Fix, commit, create PR → develop
194194
```
195195

196196
**Critical Production Bugs** (hotfix):
@@ -209,7 +209,7 @@ git add mcp-server.py
209209
git commit -m "Fix critical crash in MCP server template rendering"
210210
git push origin hotfix/mcp-server-crash
211211

212-
# Create MR → main (fast-track approval)
212+
# Create PR → main (fast-track approval)
213213
# After merge to main:
214214

215215
# Also merge to develop
@@ -254,7 +254,7 @@ All branches run automated checks:
254254

255255
### Requesting Review
256256

257-
**Good MR Description**:
257+
**Good PR Description**:
258258
```markdown
259259
## Summary
260260
Add security best practices covering secrets management, access control, and audit logging.
@@ -273,7 +273,7 @@ Add security best practices covering secrets management, access control, and aud
273273
Closes #42
274274
```
275275

276-
### Reviewing Others' MRs
276+
### Reviewing Others' PRs
277277

278278
**Check**:
279279
- [ ] Clear, descriptive commit messages
@@ -330,9 +330,9 @@ git commit -m "Prepare v1.2.0 release"
330330
git push origin release/v1.2.0
331331
```
332332

333-
**3. Create MR → main**
333+
**3. Create PR → main**
334334

335-
- Create MR: `release/v1.2.0``main`
335+
- Create PR: `release/v1.2.0``main`
336336
- Get approval from team
337337
- Ensure CI/CD passes
338338
- Merge to main
@@ -498,7 +498,7 @@ feature/WIP # Not clear
498498
- **[git-practices.md](practices/git-practices.md)** - Detailed git workflows
499499

500500
### Questions
501-
- Open an issue on GitLab
501+
- Open an issue on GitHub
502502
- Ask in team Slack channel
503503
- Contact: Uttam Jaiswal (maintainer)
504504

@@ -525,5 +525,5 @@ feature/WIP # Not clear
525525
---
526526

527527
**Maintained By**: Uttam Jaiswal
528-
**Last Updated**: 2026-02-14
529-
**Version**: 1.2.0
528+
**Last Updated**: 2026-02-20
529+
**Version**: 1.4.0

PRACTICE-INDEX.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -399,5 +399,5 @@ Are you deploying infrastructure?
399399

400400
---
401401

402-
**Last Updated:** 2026-02-17
402+
**Last Updated:** 2026-02-20
403403
**Related:** [README.md](README.md) | [CHANGELOG.md](CHANGELOG.md)

QUICK-START.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ network-infra/CLAUDE.md → ~150 lines (only networking-specific)
5252
### MCP Server + CI/CD + Tools
5353
- **mcp-server.py** - Python MCP server (5 tools: list/get practices & templates, render templates)
5454
- **health-check.sh** - Comprehensive validation script (14 checks)
55-
- **.gitlab-ci.yml** - Automated CI/CD pipeline (validates all changes)
55+
- **.github/workflows/ci.yml** - Automated GitHub Actions pipeline (validates all changes)
5656
- **CONTRIBUTING.md** ⭐ - Complete contribution guide with GitLab Flow workflows
5757
- **tools/issue-manager.sh** 🆕 - CLI tool for issue management (Advanced)
5858
- Zero dependencies for MCP server (Python stdlib only)
@@ -69,7 +69,7 @@ This keeps MCP servers organized and makes configuration easier.
6969

7070
```bash
7171
# Clone to recommended location
72-
git clone <repo-url> ~/.mcp-servers/devops-practices
72+
git clone https://github.com/ai-4-devops/devops-practices.git ~/.mcp-servers/devops-practices
7373
cd ~/.mcp-servers/devops-practices
7474

7575
# Install dependencies (if needed)
@@ -315,7 +315,7 @@ When creating a new project:
315315
| [CHANGELOG.md](CHANGELOG.md) | Version history and upgrade guides |
316316
| [mcp-server.py](mcp-server.py) | The MCP server (5 tools) |
317317
| [health-check.sh](health-check.sh) | Validation script (14 checks) |
318-
| [.gitlab-ci.yml](.gitlab-ci.yml) | CI/CD pipeline configuration |
318+
| [.github/workflows/ci.yml](.github/workflows/ci.yml) | GitHub Actions pipeline configuration |
319319
| [practices/](practices/) | 10 practice documents |
320320
| [templates/](templates/) | 4 template files |
321321

@@ -355,7 +355,7 @@ See [CHANGELOG.md](CHANGELOG.md) for complete version history.
355355

356356
**Previous Releases:**
357357
- v1.2.0: GitLab Flow branching, CONTRIBUTING.md, enhanced 02-01-git-practices
358-
- v1.1.0: render_template tool, GitLab CI/CD pipeline
358+
- v1.1.0: render_template tool, GitHub Actions pipeline
359359
- v1.0.0: runbook-documentation, configuration-management, readme-maintenance
360360

361361
---
@@ -382,5 +382,5 @@ Now that you have the MCP server set up, if you want to contribute improvements:
382382
**Questions?** See [SETUP.md](SETUP.md) for detailed troubleshooting.
383383

384384
**Maintained By**: Uttam Jaiswal
385-
**Last Updated**: 2026-02-17
386-
**Version**: 1.3.0
385+
**Last Updated**: 2026-02-20
386+
**Version**: 1.4.0

0 commit comments

Comments
 (0)