nathan/nexus-mcp
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
nexus-mcp/SETUP_COMPLETE.md
nathan a961e241cd feat(audit): complete drift detection shard implementation (Yellow → Green) 
- Implement 4 production-ready audit scan tools in src/shards/audit.py
  - scan_status_reconciliation: detect terminated users still enabled in AD
  - scan_job_title_drift: detect title mismatches between Workday and AD
  - scan_department_mismatches: detect department/cost center drift
  - scan_name_variance_mismatches: detect display name inconsistencies
- Add comprehensive integration test suite (tests/integration_test_audit_shard.py)
- Create demo client (test_client.py) and MCP protocol simulator (test_mcp_protocol.py)
- Add tool catalog generator (list_tools.py) for visibility across all 33 registered tools
- Fix Windows console encoding in src/main.py to support emoji in shard status output
- Add version management utility (scripts/bump_version.py) for release automation
- Update workday test imports to use new drift_detection module path

Completes session goal of establishing SOC 2-compliant cross-system drift detection
per SESSION_SNAPSHOT_2026-04-13.md. All audit tools validated against mock data
with expected mismatch scenarios (Bob Martinez, Carol Chen, David Kim cases).

Refs: WIS-014, WIS-015, WIS-016, WIS-017, WIS-018
2026-04-13 13:02:03 -04:00

3.4 KiB
Raw Blame History

✅ VS Code & CI/CD Setup - Quick Reference

🚀 You're All Set!

The Nexus MCP server is now registered in VS Code with full CI/CD pipeline.

🎯 Quick Actions

Use MCP Server in VS Code

# 1. Reload VS Code
Ctrl+Shift+P → "Developer: Reload Window"

# 2. Open Copilot Chat (@)

# 3. Type: @nexus 
# You'll see: nexus - Nexus MCP Server (48 tools)

# 4. Try it:
@nexus scan_status_reconciliation
@nexus list all audit tools

Run Tests

cd nexus-mcp

# Quick test
pytest tests/integration_test_audit_shard.py -v

# Full suite
pytest tests/ -v

Bump Version

# Local
python scripts/bump_version.py patch

# Or via GitHub Actions
# Actions → "Auto Version Bump" → Run workflow

📁 Files Created

VS Code Configuration

  • ✅ .vscode/settings.json - MCP server registration
  • ✅ .vscode/launch.json - Debug configurations

CI/CD Pipeline

  • ✅ .github/workflows/nexus-mcp-ci.yml - Main pipeline
  • ✅ .github/workflows/version-bump.yml - Auto version bump

Scripts & Tools

  • ✅ scripts/bump_version.py - Version management
  • ✅ VSCODE_INTEGRATION_GUIDE.md - Full documentation

🔄 Will Registration Need Updates?

✅ Auto (No Action Needed)

  • Adding/removing tools
  • Changing tool implementations
  • Updating dependencies

⚠️ Manual (Update .vscode/settings.json)

  • Adding new shards
  • Changing environment variables
  • Moving server location

How to check: Review VSCODE_INTEGRATION_GUIDE.md

🏗️ CI/CD Pipeline

Runs on:

  • Every push to main/develop
  • Every pull request
  • Manual trigger

Checks:

  • ✅ Tests (Python 3.11-3.13)
  • ✅ Server validation
  • ✅ Security scan
  • ✅ Version check (PRs)
  • ✅ Build package

View Status: GitHub → Actions tab → Latest runs

📚 Documentation

File Purpose
VSCODE_INTEGRATION_GUIDE.md Complete setup & maintenance guide
nexus-mcp/TEST_VALIDATION_REPORT.md Production readiness report
nexus-mcp/DEMO_GUIDE.md Testing & demo scripts
nexus-mcp/README.md Server documentation

🐛 Troubleshooting

MCP server not showing in Copilot Chat?

  1. Reload VS Code window
  2. Check: View → Output → GitHub Copilot Chat
  3. Verify .vscode/settings.json has github.copilot.chat.mcpServers

Tools not working?

  1. Check server can start: python nexus-mcp/src/main.py
  2. Run test client: python nexus-mcp/test_client.py
  3. Check environment: USE_MOCK=true in config

CI pipeline failing?

  1. View logs: GitHub → Actions → Failed run
  2. Run tests locally: pytest tests/ -v
  3. Check version was bumped (PRs)

🎉 Next Steps

  1. Test Integration

    • Reload VS Code
    • Try @nexus in Copilot Chat
    • Run a tool: @nexus scan_status_reconciliation

  2. Commit This Setup

    git add .vscode/ .github/ scripts/ *.md
git commit -m "chore: add VS Code integration & CI/CD pipeline"
git push origin rebuild-audit-tools

  3. Create PR to Main

    • CI pipeline will run automatically
    • Version check will enforce version bump
    • Merge after approval

  4. Celebrate! 🎉

    • You now have MCP server in VS Code
    • Full CI/CD validation
    • Automated version management

Need Help? See VSCODE_INTEGRATION_GUIDE.md