9 powerful AI development tools for Claude Code, Cursor, Windsurf, and all MCP-compatible editors
Major Performance Boost:
- π 2.18x speedup with intelligent caching (99.9% hit rate)
- β‘ AST parsing 73% faster with content-based cache invalidation
- π Hash generation: 673K ops/sec throughput
- β Zero breaking changes - fully backwards compatible
Key Features:
- β¨ Intelligent caching in test-generator, security-scanner, smart-reviewer
- π Reusable performance benchmark suite
- π Content-based automatic cache invalidation
- π Built-in cache statistics and monitoring
Metrics:
Analysis Cache: 2.18x speedup (99.9% hit rate)
AST Parsing: 73% faster with cache
Hash Generation: 673K ops/sec
Tests: 853 total (+228 from v1.0.30)
Pass Rate: 100% (853/853)
Test Expansion:
- β Added 225 new tests (625 β 850)
- β Smart-reviewer analyzers: 0% β 100% coverage
- β
Strengthened api-designer assertions (removed shallow
toBeDefined()
)
Code Modernization:
- β ESLint 9 + Prettier with flat config
- β
AST parser with
@babel/parser
(eliminated ReDoS vulnerabilities) - β Auto-fixed 69 code quality issues
Security & Reliability:
- β Fixed orchestrator batch operations bug (critical)
- β 100% validation coverage (32 security tests)
- β
Standardized 58 error codes with
MCPError
class - β 20 integration tests for real-world workflows
See CHANGELOG.md for complete v1.0.31 release notes.
- ποΈ Architecture: Centralized error handling, reduced complexity
- β Quality: ESLint + Prettier enforced, AST-based parsing
3 Pre-built Workflows:
- pre-commit (2 steps) - Fast local checks: code review + security scan
- pre-merge (4 steps) - Comprehensive PR validation with dependency resolution
- quality-audit (3 steps) - Deep analysis: security report + architecture + docs
Key Features:
- π MCP-to-MCP communication via JSON-RPC
- π Dependency resolution (steps can depend on other steps)
- β‘ Parallel execution where possible
- β 48/48 tests passing (includes 20 integration tests)
CI Coverage Enforcement - Actual Metrics:
- β Coverage (deduplicated): 59% statements, 67% branches, 74% functions
- β Enforced thresholds: 55% statements, 65% branches, 72% functions
- β
Automated validation with
check-coverage.js
(proper deduplication) - β
Visual coverage dashboard with
coverage-dashboard.js
- β All 622 tests passing (100% pass rate)
342 New Tests Added (+46% growth):
- API Designer: 3 β 140 tests (+4567%) - OpenAPI, GraphQL, client generation, validation
- Refactor Assistant: 170 β 311 tests (+83%) - async conversion, dead code, design patterns
- Security Scanner: 8 β 64 tests (+700%) - secrets, SQL injection, XSS, utilities
Refactor Assistant Improvements:
- Created modular transformation utilities (async-converter, dead-code-detector)
- Extracted pattern factory to eliminate 50-line switch statement
- Reduced complexity from 78 β 71 (-9%)
- Code size reduced from 462 β 410 lines (-11%)
Overall:
- β 622 passing tests (100% pass rate)
- β Coverage: 59% statements, 67% branches, 74% functions (verified, deduplicated)
- β Comprehensive test coverage across all packages
- β Enforced quality standards in CI/CD pipeline
Previous Release (v1.0.28):
- π Complete documentation restructuring
- π 7 organized categories with central index
- β Improved navigation and discoverability
v1.0.27:
Security Scanner - Perfect Score 100/100 β
- Score improved from 57 β 100/100 (+75%)
- Complexity reduced by 54% (71 β 33)
- Maintainability increased 245% (11 β 38)
- Duplicate code reduced 94% (35 β 2 blocks)
- 47% smaller codebase (395 β 209 lines)
DB Schema Designer - Near Perfect 97/100 β
- Score improved from 75 β 97/100 (+29%)
- Complexity reduced by 49% (83 β 42)
- Maintainability increased 121% (14 β 31)
- Duplicate code reduced 41% (22 β 13 blocks)
- 36% smaller codebase (411 β 262 lines)
Refactor Assistant - Stable 67/100
- Complexity reduced 7% (84 β 78)
- Constants extraction and error handling improvements
CodeRabbit Review - All Clear β
- β 9/9 issues resolved (3 critical, 3 major, 3 minor)
- β SQL injection prevention with input validation
- β Dependency scanner false positive fixes
- β Semver upgraded to v7.7.2
Overall Impact:
- β +33% average score improvement (66 β 88)
- β -36% complexity reduction
- β +122% maintainability improvement
- β -52% duplicate code reduction
- β 0 security vulnerabilities (validated by Security Scanner MCP)
- β 100% test pass rate (68/68 tests)
Previous Updates:
- π CI/CD Templates - GitHub Actions, GitLab CI, pre-commit hooks
- π― Global Version Management -
version.json
single source of truth
Install all 9 tools instantly with one command:
# For Claude Code (default)
npx @j0kz/mcp-agents@latest
# For other editors
npx @j0kz/mcp-agents@latest cursor # Cursor
npx @j0kz/mcp-agents@latest windsurf # Windsurf
npx @j0kz/mcp-agents@latest vscode # VS Code
npx @j0kz/mcp-agents@latest roo # Roo Code
npx @j0kz/mcp-agents@latest trae # Trae
That's it! The installer will:
- β Clear npm cache
- β Fix malformed config files automatically
- β
Configure MCP settings with
@latest
versions - β Pre-install all 9 tools (including orchestrator)
- β Bypass npx cache issues
Restart your editor and all 9 MCP tools will be ready to use.
π More installation options
# List all available tools
npx @j0kz/mcp-agents list
# Clear cache if having issues
npx @j0kz/mcp-agents clear-cache
# Show help (see all supported editors)
npx @j0kz/mcp-agents help
Supported Editors:
- Claude Code, Cursor, Windsurf, VS Code, Roo Code, Trae
Or use the manual installation guide below.
Add MCP quality checks to your pipeline in < 1 minute:
Quick Start:
# Basic quality check on PRs
curl -o .github/workflows/mcp-basic.yml \
https://raw.githubusercontent.com/j0KZ/mcp-agents/main/templates/github-actions/mcp-basic.yml
Available Templates:
- mcp-basic.yml - Quick code review + security scan
- mcp-quality-gate.yml - Comprehensive 5-job pipeline
- mcp-pre-merge.yml - Strict enforcement before merge
Install locally:
npx @j0kz/mcp-hooks-generator basic
Modes: basic, strict, minimal, custom
# .gitlab-ci.yml
include:
- remote: 'https://raw.githubusercontent.com/j0KZ/mcp-agents/main/templates/gitlab-ci/mcp-quality-gate.gitlab-ci.yml'
π Full CI/CD Guide | Browse Templates
- Rebuilt dist files with correct @j0kz/shared imports
- Fixed ERR_MODULE_NOT_FOUND errors completely
- Published @j0kz/shared package to npm
- Updated all package.json dependencies
- Fixed ERR_MODULE_NOT_FOUND error
- Major complexity reduction in API Designer (67% reduction)
- Enhanced accuracy in Smart Reviewer
- All 37 tests passing with zero breaking changes
- Better maintainability with modular architecture
- Major dependency updates (Anthropic SDK, MCP SDK, Vitest)
- Zero vulnerabilities
- Enhanced test infrastructure
- Security hardened with ReDoS vulnerability fixes
- 19 comprehensive examples and tutorials
- Performance benchmarking infrastructure
- Structured error codes
Choose your AI-powered code editor below and follow the simple installation steps:
π¨ Claude Code (Anthropic) - Click to expand
Mac/Linux:
curl -fsSL https://raw.githubusercontent.com/j0KZ/mcp-agents/main/install-all.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/j0KZ/mcp-agents/main/install-all.ps1 | iex
# Install all 9 tools individually
claude mcp add smart-reviewer "npx @j0kz/smart-reviewer-mcp" --scope user
claude mcp add test-generator "npx @j0kz/test-generator-mcp" --scope user
claude mcp add architecture-analyzer "npx @j0kz/architecture-analyzer-mcp" --scope user
claude mcp add doc-generator "npx @j0kz/doc-generator-mcp" --scope user
claude mcp add security-scanner "npx @j0kz/security-scanner-mcp" --scope user
claude mcp add refactor-assistant "npx @j0kz/refactor-assistant-mcp" --scope user
claude mcp add api-designer "npx @j0kz/api-designer-mcp" --scope user
claude mcp add db-schema "npx @j0kz/db-schema-mcp" --scope user
claude mcp add orchestrator "npx @j0kz/orchestrator-mcp" --scope user
β Verify Installation:
claude mcp list
You should see all 9 tools marked as "β Connected"
β‘ Cursor (Anysphere) - Click to expand
Mac/Linux:
curl -o ~/.cursor/mcp_config.json https://raw.githubusercontent.com/j0KZ/mcp-agents/main/mcp_config_all.json
Windows (PowerShell):
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/j0KZ/mcp-agents/main/mcp_config_all.json" -OutFile "$env:APPDATA\Cursor\User\mcp_config.json"
- Open Cursor Settings (Ctrl/Cmd + ,)
- Search for "MCP" or "Model Context Protocol"
- Click "Edit in settings.json"
- Add this configuration:
{
"mcpServers": {
"smart-reviewer": {
"command": "npx",
"args": ["@j0kz/smart-reviewer-mcp"]
},
"test-generator": {
"command": "npx",
"args": ["@j0kz/test-generator-mcp"]
},
"architecture-analyzer": {
"command": "npx",
"args": ["@j0kz/architecture-analyzer-mcp"]
},
"doc-generator": {
"command": "npx",
"args": ["@j0kz/doc-generator-mcp"]
},
"security-scanner": {
"command": "npx",
"args": ["@j0kz/security-scanner-mcp"]
},
"refactor-assistant": {
"command": "npx",
"args": ["@j0kz/refactor-assistant-mcp"]
},
"api-designer": {
"command": "npx",
"args": ["@j0kz/api-designer-mcp"]
},
"db-schema": {
"command": "npx",
"args": ["@j0kz/db-schema-mcp"]
}
}
}
Then restart Cursor!
π Windsurf (Codeium) - Click to expand
Mac/Linux:
curl -o ~/.windsurf/mcp_config.json https://raw.githubusercontent.com/j0KZ/mcp-agents/main/mcp_config_all.json
Windows (PowerShell):
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/j0KZ/mcp-agents/main/mcp_config_all.json" -OutFile "$env:APPDATA\Windsurf\User\mcp_config.json"
- Open Windsurf Settings
- Navigate to "Extensions" β "Model Context Protocol"
- Click "Edit MCP Settings"
- Add the same JSON configuration as shown in the Cursor section above
Then restart Windsurf!
π¦ Roo Code (Roo-Cline) - Click to expand
# Install via Roo Code CLI
roo mcp add smart-reviewer npx @j0kz/smart-reviewer-mcp
roo mcp add test-generator npx @j0kz/test-generator-mcp
roo mcp add architecture-analyzer npx @j0kz/architecture-analyzer-mcp
roo mcp add doc-generator npx @j0kz/doc-generator-mcp
roo mcp add security-scanner npx @j0kz/security-scanner-mcp
roo mcp add refactor-assistant npx @j0kz/refactor-assistant-mcp
roo mcp add api-designer npx @j0kz/api-designer-mcp
roo mcp add db-schema npx @j0kz/db-schema-mcp
Then restart Roo Code!
π Continue.dev - Click to expand
- Open VS Code
- Install the Continue extension from the marketplace
- Open Continue settings (click Continue icon β βοΈ)
- Edit
~/.continue/config.json
and add:
{
"mcp": [
{
"name": "smart-reviewer",
"command": "npx",
"args": ["@j0kz/smart-reviewer-mcp"]
},
{
"name": "test-generator",
"command": "npx",
"args": ["@j0kz/test-generator-mcp"]
},
{
"name": "architecture-analyzer",
"command": "npx",
"args": ["@j0kz/architecture-analyzer-mcp"]
},
{
"name": "doc-generator",
"command": "npx",
"args": ["@j0kz/doc-generator-mcp"]
},
{
"name": "security-scanner",
"command": "npx",
"args": ["@j0kz/security-scanner-mcp"]
},
{
"name": "refactor-assistant",
"command": "npx",
"args": ["@j0kz/refactor-assistant-mcp"]
},
{
"name": "api-designer",
"command": "npx",
"args": ["@j0kz/api-designer-mcp"]
},
{
"name": "db-schema",
"command": "npx",
"args": ["@j0kz/db-schema-mcp"]
}
]
}
Then restart VS Code!
β‘ Zed (Zed Industries) - Click to expand
- Open Zed
- Press
Cmd/Ctrl + ,
to open Settings - Navigate to "Language Models" β "Model Context Protocol"
- Add the MCP servers configuration:
{
"context_servers": {
"smart-reviewer": {
"command": "npx",
"args": ["@j0kz/smart-reviewer-mcp"]
},
"test-generator": {
"command": "npx",
"args": ["@j0kz/test-generator-mcp"]
},
"architecture-analyzer": {
"command": "npx",
"args": ["@j0kz/architecture-analyzer-mcp"]
},
"doc-generator": {
"command": "npx",
"args": ["@j0kz/doc-generator-mcp"]
},
"security-scanner": {
"command": "npx",
"args": ["@j0kz/security-scanner-mcp"]
},
"refactor-assistant": {
"command": "npx",
"args": ["@j0kz/refactor-assistant-mcp"]
},
"api-designer": {
"command": "npx",
"args": ["@j0kz/api-designer-mcp"]
},
"db-schema": {
"command": "npx",
"args": ["@j0kz/db-schema-mcp"]
}
}
}
Then restart Zed!
π― Trae (AI Code Editor) - Click to expand
- Open Trae
- Go to Settings β Extensions β Model Context Protocol
- Click "Add MCP Server" or edit the MCP configuration file
- Add this configuration:
Configuration Format:
{
"mcpServers": {
"smart-reviewer": {
"command": "npx",
"args": ["@j0kz/smart-reviewer-mcp"]
},
"test-generator": {
"command": "npx",
"args": ["@j0kz/test-generator-mcp"]
},
"architecture-analyzer": {
"command": "npx",
"args": ["@j0kz/architecture-analyzer-mcp"]
},
"doc-generator": {
"command": "npx",
"args": ["@j0kz/doc-generator-mcp"]
},
"security-scanner": {
"command": "npx",
"args": ["@j0kz/security-scanner-mcp"]
},
"refactor-assistant": {
"command": "npx",
"args": ["@j0kz/refactor-assistant-mcp"]
},
"api-designer": {
"command": "npx",
"args": ["@j0kz/api-designer-mcp"]
},
"db-schema": {
"command": "npx",
"args": ["@j0kz/db-schema-mcp"]
}
}
}
Note: The property name is mcpServers
(camelCase), not mcp_servers
.
Then restart Trae!
π§ Any MCP-Compatible Editor - Click to expand
If your editor supports MCP but isn't listed above:
- Find your editor's MCP configuration file location
- Add this configuration (adjust format as needed):
{
"mcpServers": {
"smart-reviewer": {
"command": "npx",
"args": ["@j0kz/smart-reviewer-mcp"]
},
"test-generator": {
"command": "npx",
"args": ["@j0kz/test-generator-mcp"]
},
"architecture-analyzer": {
"command": "npx",
"args": ["@j0kz/architecture-analyzer-mcp"]
},
"doc-generator": {
"command": "npx",
"args": ["@j0kz/doc-generator-mcp"]
},
"security-scanner": {
"command": "npx",
"args": ["@j0kz/security-scanner-mcp"]
},
"refactor-assistant": {
"command": "npx",
"args": ["@j0kz/refactor-assistant-mcp"]
},
"api-designer": {
"command": "npx",
"args": ["@j0kz/api-designer-mcp"]
},
"db-schema": {
"command": "npx",
"args": ["@j0kz/db-schema-mcp"]
}
}
}
- Restart your editor
Need help? Open an issue with your editor name!
AI-powered code review with quality metrics and automated fixes
Example:
π¬ "Review the auth.js file"
π€ Found 3 issues: unused variable on line 42, missing error handling,
inconsistent formatting. Here are the fixes...
Generate comprehensive test suites with edge cases and mocks
Example:
π¬ "Generate tests for calculatePrice function"
π€ Generated 15 tests covering: happy path, edge cases (negative prices,
zero), error handling, boundary conditions...
Intelligent code refactoring with pattern detection
Example:
π¬ "Refactor this function to be more readable"
π€ Suggestions: Extract 3 methods, rename variables (xβuserId),
remove nested ifs, add early returns...
Detect circular dependencies, layer violations, and generate dependency graphs
Example:
π¬ "Analyze project architecture"
π€ Found: 2 circular dependencies (auth β user),
3 layer violations (UI calls Database directly)...
Design REST and GraphQL APIs with OpenAPI generation
Example:
π¬ "Design a REST API for user management"
π€ Created design: GET/POST /users, GET/PUT/DELETE /users/:id,
POST /users/:id/verify. Includes auth, validation...
Database schema design with migrations and relationship analysis
Example:
π¬ "Design a schema for an e-commerce app"
π€ Created schema: users, products, orders, order_items
with relationships, indexes, constraints...
Auto-generate JSDoc, README, and API documentation from code
Example:
π¬ "Document the API endpoints in server.js"
π€ Generated OpenAPI spec with 12 endpoints, parameters,
responses, and examples...
Scan for vulnerabilities, OWASP issues, and security best practices
Example:
π¬ "Scan for security vulnerabilities"
π€ Found: SQL injection risk in query builder, XSS in template,
hardcoded API key, outdated dependency...
- Run the install command (one line, see above)
- Restart your editor
- Chat naturally - Just ask your AI assistant
- Get results - The tools work behind the scenes
No API keys, no complex config, no accounts needed!
After installation, just chat naturally:
# Code Review
"Review my code for issues"
"What code smells are in this file?"
"Check code quality metrics"
# Testing
"Generate tests for this function"
"What test cases am I missing?"
"Create integration tests"
# Architecture
"Analyze project architecture"
"Find circular dependencies"
"Generate dependency graph"
# Documentation
"Generate API documentation"
"Add JSDoc comments"
"Create README"
# Security
"Scan for security issues"
"Check OWASP Top 10 compliance"
"Find hardcoded secrets"
# Refactoring
"Refactor this code"
"Extract reusable patterns"
"Improve class design"
# API Design
"Design a REST API for..."
"Generate OpenAPI spec"
"Review API best practices"
# Database
"Design database schema"
"Generate migrations"
"Optimize this schema"
Check out the examples/
directory for comprehensive guides:
- Getting Started Tutorial - Your first steps with the toolkit
- Common Workflows - Real-world usage patterns
- Advanced Usage - Power user techniques
- Best Practices - Tips for optimal results
Each tool has dedicated examples with sample code and expected outputs!
Editor | Status | Installation Method |
---|---|---|
Claude Code | β Full support | Use install script (recommended) |
Cursor | β Full support | Download mcp_config_all.json |
Windsurf | β Full support | Download mcp_config_all.json |
Roo Code | β Full support | MCP-compatible config |
Continue | β Full support | MCP plugin support |
Zed | β Full support | Native MCP support |
Any MCP-compatible editor works!
Want just one tool? Install individually:
# Claude Code
claude mcp add smart-reviewer "npx @j0kz/smart-reviewer-mcp" --scope user
claude mcp add test-generator "npx @j0kz/test-generator-mcp" --scope user
claude mcp add architecture-analyzer "npx @j0kz/architecture-analyzer-mcp" --scope user
claude mcp add doc-generator "npx @j0kz/doc-generator-mcp" --scope user
claude mcp add security-scanner "npx @j0kz/security-scanner-mcp" --scope user
claude mcp add refactor-assistant "npx @j0kz/refactor-assistant-mcp" --scope user
claude mcp add api-designer "npx @j0kz/api-designer-mcp" --scope user
claude mcp add db-schema "npx @j0kz/db-schema-mcp" --scope user
For Cursor/Windsurf, add individual entries to mcp_config.json
- see config template.
Claude Code:
claude mcp list
You should see all 8 tools marked as "β Connected"
Cursor/Windsurf: Check your editor's MCP settings panel
Visit our Wiki for complete documentation:
- Quick Start Guide - Get started in 5 minutes
- Configuration - Editor setup for Claude Code, Cursor, Windsurf, Roo Code
- Integration Patterns - Chain MCPs together for powerful workflows
- Troubleshooting - Common issues and solutions
- Smart Reviewer - Code review and quality analysis
- Architecture Analyzer - Dependency and architecture analysis
- Test Generator - Automated test generation
- Security Scanner - Security vulnerability scanning
- API Designer - REST and GraphQL API design
- DB Schema - Database schema design
- Doc Generator - Auto-generate documentation
- Refactor Assistant - Code refactoring
- π Documentation Index - Complete documentation catalog
- Modularity Implementation - Technical details on shared utilities
- Editor Compatibility - Full compatibility matrix
- Security Policy - Security guidelines and reporting
- Contributing Guide - How to contribute to the project
- Code of Conduct - Community guidelines
- Roadmap - Future plans and features
- Restart your editor after installation
- Check Node.js is installed:
node --version
- Verify installation:
claude mcp list
(Claude Code) - See Troubleshooting Guide for detailed solutions
- Make sure you restarted the editor
- Try asking more specific questions
- Check MCP connection status
- Open an issue
- Check individual package READMEs for detailed docs
mcp-agents/
βββ packages/
β βββ smart-reviewer/ # Code review & quality
β βββ test-generator/ # Test suite generation
β βββ architecture-analyzer/# Dependency analysis
β βββ doc-generator/ # Documentation tools
β βββ security-scanner/ # Security scanning
β βββ refactor-assistant/ # Refactoring tools
β βββ api-designer/ # API design
β βββ db-schema/ # Database design
βββ install-all.sh # Mac/Linux installer
βββ install-all.ps1 # Windows installer
βββ mcp_config_all.json # Complete MCP config
Each package is independently published to npm under the @j0kz
scope.
Contributions welcome! Please:
- Fork the repo
- Create a feature branch
- Make your changes
- Submit a pull request
MIT Β© j0KZ
Each package is independently licensed under MIT.
- npm: @j0kz
- GitHub: j0KZ/mcp-agents
- Issues: Report a bug
- MCP Protocol: modelcontextprotocol.io
If you find these tools useful, please star the repo to help others discover it!
Made with β€οΈ for the AI developer community