# MCP Vibe Coding Tools

**Complete Autonomous Development Organization** - Transform any prompt into a fully functional, production-ready, revenue-generating product with zero human intervention.

## 🎯 Mission: From Prompt to Profit

This MCP server operates as a **complete software development company in a box**, providing 100+ tools that enable AI to function as:

- **📋 Requirements Team** - Requirements analysis, user stories, acceptance criteria
- **📊 Product Team** - Roadmaps, competitive analysis, market research  
- **🔬 R&D Team** - Technology research, architecture design, proof of concepts
- **🏗️ IT Department** - Infrastructure, deployment, monitoring, automation
- **🔒 Security Team** - Vulnerability scanning, auditing, compliance, hardening
- **💻 Development Team** - Implementation, testing, code review, optimization
- **📚 Documentation Team** - Comprehensive docs, API specs, guides

### The Revolution

**Traditional AI Coding:** Generate code → Ask human for validation → Wait for approval → Repeat

**MCP Vibe Coding:** Prompt → Requirements → Architecture → Implementation → Testing → Security → Deployment → **DONE**

### Philosophy

- ✅ **Act, Don't Ask** - AI makes decisions and fixes issues automatically
- ✅ **Test Everything** - Comprehensive validation before shipping
- ✅ **Document Relentlessly** - Auto-generated, always up-to-date docs
- ✅ **Automate Ruthlessly** - Scripts and CI/CD for everything
- ✅ **Quality First** - Production-ready code only

## 🚀 What Makes This Different

### Traditional AI Coding Tools

- Ask for permission before actions
- Require manual testing and validation
- Generate documentation as an afterthought
- Need human intervention for bug fixes
- Create technical debt

### MCP Vibe Coding Tools

- **Autonomous execution** - Fix issues without asking
- **Built-in validation** - Auto-test, auto-lint, auto-build
- **Self-documenting** - Generate docs as code evolves
- **Iterative fixing** - Debug and resolve automatically
- **Production quality** - Ship only fully validated code

## ⚠️ Critical: SDK Version Compatibility

**ALWAYS ensure package.json matches the installed MCP SDK version!**

This project uses `@modelcontextprotocol/sdk@^1.24.3` with the modern `McpServer` API.

**If you see `v3Schema.safeParseAsync is not a function`:**

This is usually a **client cache issue**, not a server issue. See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for full fix.

**Quick fix:**
1. Clean rebuild: `rm -rf dist node_modules && npm install && npm run build`
2. **Completely quit and restart your MCP client** (Claude Desktop, Cursor, etc.)
3. Clear client cache if needed (see troubleshooting guide)

Version mismatches between package.json and node_modules will break the server.

## 📦 Three MCP Servers

This package provides **three separate MCP servers**:

### 1. `mcp-vibe-coding-tools` (Main Server)
Local development tools for filesystem, git, testing, automation, diagnostics, kubernetes, and RAG.

**Entry point:** `dist/mcp-vibe-coding-tools.js`

### 2. `mcp-gitops-tools` (GitOps Server)
Remote GitOps operations for GitHub Actions, GitLab CI/CD, and GitLab API.

**Entry point:** `dist/gitops-server.js`

### 3. `mcp-gcloud-tools` (Google Cloud Server) 🆕
Google Cloud Platform integration with 35+ tools for GKE, BigQuery, Cloud Run, Dataflow, Logging, and more. Uses Application Default Credentials (ADC) for seamless authentication.

**Entry point:** `dist/gcloud-server.js`

**Documentation:**
- [GCP_README.md](GCP_README.md) - Complete overview
- [GCP_QUICKSTART.md](GCP_QUICKSTART.md) - Quick start guide
- [GCP_TOOLS.md](GCP_TOOLS.md) - All 35+ tools reference
- [GCP_EXAMPLES.md](GCP_EXAMPLES.md) - Real-world examples

---

## 📦 150+ Production-Ready Tools Across 20+ Categories

### Filesystem Operations (6 tools)

- `read_file` - Read files with encoding support
- `write_file` - Create/update files safely
- `list_directory` - Browse directory trees
- `search_files` - Find files by glob pattern
- `file_info` - Get file metadata
- `create_directory` - Create directory structures

### CLI Execution (3 tools)

- `execute_command` - Run shell commands
- `get_environment` - Access environment variables
- `which_command` - Find command locations

### Git Operations (9 tools)

- `git_status`, `git_log`, `git_diff` - Repository inspection
- `git_branch`, `git_commit` - Version control
- `git_push`, `git_pull`, `git_clone` - Remote operations
- `git_stash` - Temporary storage

### Web & HTTP (4 tools)

- `fetch_webpage` - Download web content
- `parse_html` - Extract structured data
- `extract_links` - Get all links
- `download_file` - Save remote files

### Node.js/npm (5 tools)

- `npm_install` - Manage packages
- `npm_run_script` - Execute scripts
- `npm_outdated` - Check dependencies
- `npm_init` - Create projects
- `read_package_json` - Read metadata

### Python/pip (5 tools)

- `python_create_venv` - Virtual environments
- `pip_install` - Install packages
- `pip_freeze` - Generate requirements
- `python_run_script` - Execute code
- `python_version` - Check version

### Testing & Building (4 tools)

- `run_tests` - Execute test suites
- `build_project` - Compile/build
- `start_dev_server` - Run dev servers
- `lint_code` - Code quality checks

### **🤖 Automation & Orchestration (5 tools)**

#### `validate_project`

Run complete project validation suite:
- Linting with auto-fix
- Type checking
- Test execution with coverage
- Build verification
- **Auto-iterates until all checks pass**

#### `create_validation_script`

Generate comprehensive validation scripts:
- Add lint, test, build commands to package.json
- Set up pre-commit hooks
- Configure coverage thresholds
- Create validation pipeline

#### `setup_project_automation`

Complete automation setup:
- GitHub Actions / GitLab CI workflows
- Dependabot configuration
- Pre-commit hooks
- Makefile for cross-platform commands

#### `generate_project_docs`

Auto-generate documentation:
- CONTRIBUTING.md with dev workflow
- ARCHITECTURE.md with system design
- CHANGELOG.md with version history
- API documentation

#### `fix_common_issues`

Detect and auto-fix problems:
- Missing package.json scripts
- Missing .gitignore
- Missing README
- Outdated dependencies
- **Fixes issues without asking**

### **🔍 Diagnostics & Logging (8 tools)**

#### `get_vscode_problems`
Get real-time compilation and linting errors:
- Runs TypeScript compiler to find type errors
- Executes ESLint to detect code quality issues
- Returns structured problem list with file, line, severity
- Filter by file path or severity level
- **Essential for autonomous error fixing**

#### `read_log_file`

Read and parse log files with smart filtering:
- Tail last N lines (like `tail -n`)
- Filter by log level (ERROR, WARN, INFO, DEBUG)
- Apply custom regex patterns
- Parse structured logs (JSON, timestamp formats)
- Extract timestamps, levels, messages

#### `tail_log_file`

Monitor log files for recent activity:
- Get snapshot of recent log entries
- Useful for monitoring build/test output
- View last N lines of any log file

#### `search_logs`

Search all logs for specific patterns:
- Recursive search through log directories
- Context lines before/after matches
- Regex pattern support
- Group matches by file
- **Find error patterns across entire workspace**

#### `find_log_files`

Discover all log files in workspace:
- Glob pattern matching (*.log, **/*.log)
- File size and modification time
- Sort by most recent
- Exclude node_modules by default

#### `analyze_error_logs`

Deep analysis of log files for errors:
- Extract errors, warnings, exceptions
- Parse stack traces automatically
- Categorize error types
- Count error patterns
- **Identify root causes autonomously**

#### `watch_log_changes`

Monitor log file changes incrementally:
- Read only new content since last position
- Efficient incremental log monitoring
- Get byte position for next read
- Perfect for long-running processes

#### `get_terminal_history`

Access recent terminal commands:
- Read zsh/bash history files
- Parse timestamps (zsh extended format)
- Filter by command pattern
- **Learn from previous command executions**

#### `aggregate_logs`

Combine and analyze multiple log files:
- Group by level, file, hour, or day
- Extract time ranges
- Count entries by category
- **See big picture across all logs**

#### `get_xcode_logs`

Get Xcode build logs, crash logs, and simulator logs:
- Build logs from DerivedData
- Simulator runtime logs
- Crash reports from DiagnosticReports
- Device logs (requires libimobiledevice)

#### `get_android_logs`

Get Android logcat and build logs:
- Logcat with priority/tag filtering
- Gradle build logs
- Parse structured log format

#### `get_react_native_logs`

Get React Native Metro bundler and app logs:
- Metro bundler output
- iOS simulator logs
- Android logcat for RN apps

### Kubernetes Operations (7 tools)

#### `kubectl_get_pods`
List pods in a namespace with status information.

#### `kubectl_describe_pod`
Get detailed information about a specific pod.

#### `kubectl_get_logs`
Fetch logs from a pod with filtering options.

#### `kubectl_get_deployments`
List all deployments with replica status.

#### `kubectl_get_services`
List all services with IP and port information.

#### `kubectl_get_events`
Get cluster events for debugging issues.

#### `kubectl_get_resource_status`
Get status of any Kubernetes resource type.

**Note:** All kubectl tools are read-only - for validation and debugging only, no destructive operations.

### GitHub Actions (6 tools)

#### `github_list_workflow_runs`
List workflow runs with optional filters (status, branch).

#### `github_get_workflow_run`
Get details of a specific workflow run.

#### `github_list_workflow_jobs`
List all jobs in a workflow run.

#### `github_get_job_logs`
Fetch logs for a specific job.

#### `github_list_workflows`
List all workflows in a repository.

#### `github_get_workflow_run_logs`
Download complete workflow run logs as base64-encoded zip.

**Environment Variable Required:** 
- `GITHUB_API_KEY` - GitHub Personal Access Token with `repo` and `actions:read` scopes

**Error Handling:** Tools only error when invoked without `GITHUB_API_KEY` set - they do NOT error on server startup.

### RAG (Retrieval Augmented Generation) (6 tools)

Enable local document search and retrieval for AI coding assistants. Perfect for searching through documentation, codebases, and reference materials.

**Environment Variables:**
- `RAG_DOCS_PATH` - **Required** - Path to directory containing documents to index

**Note:** The index is automatically stored in `.rag-index` folder inside `RAG_DOCS_PATH`. Chunk size (1000) and overlap (200) are sensible defaults.

#### `rag_index_documents`
Index local documents for semantic search:
- Scans directory for supported file types
- Chunks documents with configurable overlap
- Builds TF-IDF index for semantic similarity
- Incremental indexing (only re-indexes changed files)
- Supports 30+ file extensions (md, ts, js, py, json, yaml, etc.)

#### `rag_search`
Search indexed documents using semantic similarity:
- TF-IDF based semantic search
- Returns top-K most relevant chunks
- Configurable minimum similarity threshold
- File path filtering with regex
- **Perfect for finding relevant docs and code examples**

#### `rag_get_context`
Expand context around search results:
- Get more lines before/after a match
- Useful for understanding surrounding code
- Configurable expansion range

#### `rag_list_indexed`
List all indexed documents:
- Shows file paths, types, and chunk counts
- Optional detailed chunk information
- Index statistics and metadata

#### `rag_clear_index`
Clear the RAG index:
- Requires confirmation flag
- Removes all indexed documents

#### `rag_status`
Check RAG system status:
- Shows if RAG is enabled
- Configuration values
- Index statistics if available

**Example Configuration:**
```json
{
  "mcpServers": {
    "vibe-coding-tools": {
      "command": "node",
      "args": ["/path/to/mcp-vibe-coding-tools/dist/mcp-vibe-coding-tools.js"],
      "env": {
        "WORKSPACE_PATH": "/path/to/project",
        "RAG_DOCS_PATH": "/path/to/docs-to-search"
      }
    }
  }
}
```

### GitLab CI/CD (7 tools)

#### `gitlab_list_pipelines`
List pipelines for a project with optional filters.

#### `gitlab_get_pipeline`
Get detailed information about a specific pipeline.

#### `gitlab_list_pipeline_jobs`
List all jobs in a pipeline.

#### `gitlab_get_job`
Get details of a specific job including artifacts info.

#### `gitlab_get_job_trace`
Fetch job logs/trace output.

#### `gitlab_list_project_jobs`
List all jobs in a project with filtering.

#### `gitlab_get_pipeline_variables`
Get variables used in a pipeline execution.

### GitLab API (23 tools)

Comprehensive GitLab API integration for groups, projects, issues, and merge requests.

#### Groups
- `gitlab_get_group` - Get group details
- `gitlab_list_group_subgroups` - List subgroups
- `gitlab_list_group_projects` - List projects in group
- `gitlab_list_descendant_groups` - List all nested subgroups

#### Projects
- `gitlab_get_project` - Get project details
- `gitlab_list_projects` - List accessible projects

#### Issues
- `gitlab_list_issues` - List issues with filters
- `gitlab_get_issue` - Get issue details
- `gitlab_create_issue` - Create new issue
- `gitlab_update_issue` - Update existing issue
- `gitlab_list_issue_notes` - List issue comments
- `gitlab_create_issue_note` - Add issue comment

#### Merge Requests
- `gitlab_list_merge_requests` - List MRs with filters
- `gitlab_get_merge_request` - Get MR details
- `gitlab_merge_merge_request` - Merge an MR
- `gitlab_list_mr_changes` - Get MR diff
- `gitlab_list_mr_notes` - List MR comments
- `gitlab_create_mr_note` - Add MR comment
- `gitlab_approve_merge_request` - Approve MR

#### Global Search
- `gitlab_search_issues_global` - Search issues across all projects
- `gitlab_search_merge_requests_global` - Search MRs across all projects
- `gitlab_search_group_issues` - Search issues in a group
- `gitlab_search_group_merge_requests` - Search MRs in a group

**Environment Variables Required:**
- `GITLAB_API_KEY` - GitLab Personal Access Token or Project Access Token with `read_api` scope
- `GITLAB_HOST` (optional) - GitLab instance URL (default: `https://gitlab.com` for GitLab.com, or set to your self-hosted instance)

**Error Handling:** Tools only error when invoked without `GITLAB_API_KEY` set - they do NOT error on server startup.

### Google Cloud Platform (35+ tools) 🆕

Comprehensive GCP integration using Application Default Credentials (ADC). No API keys required - uses your gcloud authentication.

#### Authentication & Configuration (7 tools)
- `gcloud_auth_login` - Authenticate with ADC
- `gcloud_auth_list` - List authenticated accounts
- `gcloud_auth_print_access_token` - Generate access token for API calls
- `gcloud_auth_print_identity_token` - Generate identity token (JWT) for Cloud Run
- `gcloud_config_set` - Set configuration properties (project, region, zone)
- `gcloud_config_get` - Get configuration values
- `gcloud_config_list` - List all configuration

#### Cloud Logging (2 tools)
- `gcloud_logging_read` - Read logs with advanced filtering (time, severity, resource)
- `gcloud_logging_write` - Write log entries

#### GKE - Google Kubernetes Engine (4 tools)
- `gcloud_container_clusters_list` - List GKE clusters
- `gcloud_container_clusters_describe` - Get cluster details
- `gcloud_container_clusters_get_credentials` - Configure kubectl credentials
- `gcloud_container_node_pools_list` - List node pools

#### BigQuery (4 tools)
- `gcloud_bq_query` - Execute SQL queries with dry-run support
- `gcloud_bq_ls` - List datasets and tables
- `gcloud_bq_show` - Show dataset/table details and schema
- `gcloud_bq_mk` - Create datasets and tables

#### Dataflow (3 tools)
- `gcloud_dataflow_jobs_list` - List Dataflow jobs
- `gcloud_dataflow_jobs_describe` - Get job details and metrics
- `gcloud_dataflow_jobs_cancel` - Cancel running jobs

#### Resource Manager (4 tools)
- `gcloud_projects_list` - List all accessible projects
- `gcloud_projects_describe` - Get project details
- `gcloud_services_list` - List enabled/available APIs
- `gcloud_services_enable` - Enable Google Cloud APIs

#### Compute Engine (2 tools)
- `gcloud_compute_instances_list` - List VM instances
- `gcloud_compute_instances_describe` - Get instance details

#### Cloud Run (2 tools)
- `gcloud_run_services_list` - List Cloud Run services
- `gcloud_run_services_describe` - Get service details and URLs

#### Cloud Storage (2 tools)
- `gcloud_storage_buckets_list` - List storage buckets
- `gcloud_storage_ls` - List objects in buckets

#### IAM (2 tools)
- `gcloud_iam_service_accounts_list` - List service accounts
- `gcloud_iam_service_accounts_keys_create` - Create service account keys

#### Generic Wrapper (1 tool)
- `gcloud_execute` - Execute any gcloud command with proper ADC authentication

**Prerequisites:**
- gcloud CLI installed: `brew install google-cloud-sdk`
- Authenticated: `gcloud auth application-default login`
- Project set: `gcloud config set project PROJECT_ID`

**Documentation:**
- [GCP_README.md](GCP_README.md) - Complete overview
- [GCP_QUICKSTART.md](GCP_QUICKSTART.md) - Setup guide
- [GCP_TOOLS.md](GCP_TOOLS.md) - All tools reference
- [GCP_EXAMPLES.md](GCP_EXAMPLES.md) - Real-world examples

### **📋 Planning & Requirements (3 tools)**

#### `generate_requirements`
Transform ideas into comprehensive requirements:
- Functional and non-functional requirements
- User stories with acceptance criteria
- Technical constraints and success metrics
- Monetization strategy
- **Complete PRD from a prompt**

#### `create_product_roadmap`
Generate development roadmap:
- Phase breakdown (MVP → Full → Enterprise)
- Milestones and timelines
- Feature prioritization
- **Clear path from idea to launch**

#### `generate_user_stories`
Create detailed user stories:
- Acceptance criteria in Given/When/Then format
- Priority and story point estimation
- **Ready for sprint planning**

### **🔬 Research & Analysis (3 tools)**

#### `analyze_tech_stack`
Recommend optimal technologies:
- Analyze project requirements
- Recommend frameworks, databases, hosting
- Provide alternatives with reasoning
- Consider team size and expertise
- **Data-driven technology decisions**

#### `research_best_practices`
Industry best practices database:
- Security patterns (OWASP, authentication)
- Performance optimization techniques
- Testing strategies and patterns
- Deployment best practices
- **Learn from industry leaders**

#### `competitive_analysis`
Market and competitive intelligence:
- Identify opportunities and threats
- Differentiation strategies
- Market positioning recommendations
- **Strategic product decisions**

### **🏗️ Architecture & Design (3 tools)**

#### `design_system_architecture`
Complete system architecture design:
- Layered architecture (Presentation, Application, Data, Infrastructure)
- Architecture patterns (microservices, event-driven, CQRS)
- Scalability and security strategies
- Data flow diagrams
- **Production-ready architecture from day one**

#### `design_database_schema`
Database schema design:
- Entity modeling with relationships
- SQL DDL generation
- Indexes for performance
- Migration planning
- **Optimized data layer**

#### `generate_api_spec`
OpenAPI/Swagger specification:
- Complete endpoint definitions
- Request/response schemas
- Authentication schemes
- **Contract-first API development**

### **🔒 Security & Compliance (3 tools)**

#### `security_audit`
Comprehensive security scanning:
- Dependency vulnerability scanning (npm audit)
- Exposed secrets detection
- Code security issues (eval, SQL injection, XSS)
- Severity-based recommendations
- **Find vulnerabilities before attackers do**

#### `generate_security_policy`
Security policy documentation:
- Authentication/authorization guidelines
- Data protection measures
- Incident response plans
- Compliance checklists (OWASP, GDPR, SOC 2)
- **Enterprise-grade security documentation**

#### `scan_for_vulnerabilities`
Targeted vulnerability scanning:
- SAST (Static Application Security Testing)
- Dependency checks
- Secret scanning
- OWASP Top 10 validation
- **Continuous security monitoring**

### **🚀 Deployment & Infrastructure (3 tools)**

#### `generate_dockerfile`
Optimized Docker containers:
- Multi-stage builds for minimal size
- Security best practices (non-root user)
- Language-specific optimizations
- .dockerignore generation
- **Production-ready containerization**

#### `generate_cicd_pipeline`
CI/CD automation:
- GitHub Actions / GitLab CI workflows
- Automated testing and building
- Security scanning in pipeline
- Deployment automation
- **Zero-touch deployments**

#### `generate_kubernetes_manifests`
Kubernetes deployment configs:
- Deployments with replicas
- Services and load balancers
- Ingress with TLS
- Health checks (liveness/readiness)
- Resource limits and requests
- **Cloud-native deployment ready**

## 🎓 Autonomous Development Instructions

This server includes comprehensive instructions in `.github/instructions/` that guide AI assistants to:

### Core Behaviors
1. **Zero Human Intervention** - Operate autonomously by default
2. **Fix, Don't Report** - Iterate until issues are resolved
3. **Test Everything** - No untested code ships
4. **Document Thoroughly** - Always up-to-date docs
5. **Automate Relentlessly** - Scripts for all common tasks

### Quality Standards
- ✅ All tests must pass
- ✅ Zero linting errors
- ✅ Code coverage >80%
- ✅ TypeScript strict mode
- ✅ Comprehensive error handling
- ✅ Production-ready on first ship

### Workflow Automation
- Auto-run tests after code changes
- Auto-fix linting issues
- Auto-update documentation
- Auto-commit with semantic messages
- Auto-generate validation scripts

See [.github/instructions/autonomous-development.instructions.md](.github/instructions/autonomous-development.instructions.md) for complete guidelines.

## 📖 Installation

```bash
git clone https://github.com/yourusername/mcp-vibe-coding-tools.git
cd mcp-vibe-coding-tools
npm install
npm run build
```

## 🔧 Configuration

### For VS Code & GitHub Copilot

**See [VSCODE_SETUP.md](./VSCODE_SETUP.md) for detailed setup instructions.**

**Quick setup:** Run `MCP: Open User Configuration` from Command Palette and add:

```json
{
  "servers": {
    "mcp-vibe-coding-tools": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-vibe-coding-tools/dist/mcp-vibe-coding-tools.js"]
    },
    "mcp-gitops-tools": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-vibe-coding-tools/dist/gitops-server.js"],
      "env": {
        "GITHUB_API_KEY": "your-github-token",
        "GITLAB_API_KEY": "your-gitlab-token",
        "GITLAB_HOST": "https://gitlab.com"
      }
    }
  }
}
```

Replace `/path/to/mcp-vibe-coding-tools` with the absolute path to where you cloned this repo. Then it works in **any project** you open in VS Code!

### For Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "vibe-coding-tools": {
      "command": "node",
      "args": ["/path/to/mcp-vibe-coding-tools/dist/mcp-vibe-coding-tools.js"],
      "env": {
        "WORKSPACE_PATH": "/path/to/your/current/project"
      }
    },
    "gitops-tools": {
      "command": "node",
      "args": ["/path/to/mcp-vibe-coding-tools/dist/gitops-server.js"],
      "env": {
        "GITHUB_API_KEY": "your-github-token",
        "GITLAB_API_KEY": "your-gitlab-token",
        "GITLAB_HOST": "https://gitlab.com"
      }
    }
  }
}
```

For Claude, you may want to update `WORKSPACE_PATH` per project, or use a default working directory.

### For Other MCP Clients

The server uses **stdio transport** (standard for MCP) - configure similarly in:
- Cursor
- Windsurf  
- Cline
- Continue
- Any MCP-compatible client

Same pattern:
- **Main server:** `node /path/to/server/dist/mcp-vibe-coding-tools.js` with optional `WORKSPACE_PATH` env var
- **GitOps server:** `node /path/to/server/dist/gitops-server.js` with `GITHUB_API_KEY` and/or `GITLAB_API_KEY` env vars

## 🎯 Usage Examples

### Autonomous Feature Development

```text
Prompt: "Add user authentication with JWT, including tests and docs"

AI will automatically:
1. Write authentication module with error handling
2. Create comprehensive unit & integration tests
3. Run tests and fix any failures
4. Generate API documentation
5. Update README with usage examples
6. Create validation scripts
7. Set up CI/CD for auth tests
8. Commit with semantic message

You get: Production-ready, tested, documented feature ✅
```

### Autonomous Bug Fixing

```text
Prompt: "Fix the memory leak in data processor"

AI will automatically:
1. Analyze code to locate leak
2. Write fix with proper cleanup
3. Add regression tests
4. Run full test suite
5. Verify fix with profiling
6. Update CHANGELOG
7. Commit fix

You get: Bug fixed, tested, documented ✅
```

### Autonomous Project Setup

```text
Prompt: "Create a new Express API project with full automation"

AI will automatically:
1. Initialize project structure
2. Add TypeScript, testing, linting
3. Create validation scripts
4. Set up GitHub Actions
5. Add pre-commit hooks
6. Generate documentation
7. Create example endpoints with tests

You get: Production-ready project template ✅
```

## 🏗️ Architecture

Built with modern MCP SDK:

- **McpServer** class (not deprecated Server)
- **registerTool()** method (not deprecated tool())
- **Stdio transport** for universal compatibility
- **Structured responses** with proper error handling
- **Type-safe** with TypeScript strict mode

## 🔒 Security

- **Path validation** prevents directory traversal
- **No deletion tools** - files are never auto-deleted
- **Sandboxed execution** - workspace-scoped operations
- **Input sanitization** for all user data
- **Environment isolation** with virtual environments

## 🤝 Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow.

This project follows autonomous development principles:
- All PRs must pass validation
- Tests required for new features
- Documentation updated automatically
- CI/CD enforces quality standards

## 📝 License

MIT - See [LICENSE](LICENSE) file

## 🙏 Acknowledgments

Built with:
- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP standard
- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) - Official SDK
- Modern development best practices

## 🚦 Status

- ✅ 114 production tools across 2 servers
- ✅ Full autonomous workflow support
- ✅ Multi-language support (JS/TS, Python, Rust, Go)
- ✅ Comprehensive validation automation
- ✅ Self-documenting capabilities
- ✅ CI/CD integration ready
- ✅ Zero deprecated APIs

---

**Unchain your AI development workflow. Ship production code autonomously.**