Home

MCP Agents Wiki

Welcome to the MCP Agents wiki! This is your comprehensive guide to using, integrating, and extending our suite of professional MCP (Model Context Protocol) tools for AI code editors.

📚 Table of Contents

Getting Started

• Quick Start Guide - Get up and running in 5 minutes
• Installation - Detailed installation instructions
• Configuration - Configure MCPs for your editor
• First Steps - Your first MCP workflow

MCP Tools Documentation

Code Quality & Analysis

• Smart Reviewer - AI-powered code review with auto-fixes
• Architecture Analyzer - Detect circular dependencies and layer violations
• Test Generator - Automated test generation with edge cases

Security & Performance

• Security Scanner - Find vulnerabilities and secrets
• Refactor Assistant - Extract functions, apply design patterns

API & Database Design

• API Designer - Generate OpenAPI specs and GraphQL schemas
• DB Schema Designer - Design database schemas and migrations

Documentation

• Doc Generator - Auto-generate JSDoc, README, and API docs

Integration & Advanced Usage

• Shared Utilities - Modular shared package documentation
• Integration Patterns - Chain MCPs together
• Performance Optimization - Caching and batch processing
• Event-Driven Architecture - Real-time MCP communication
• Custom Workflows - Build your own pipelines

IDE Integration

• Claude Code - Setup for Claude Code
• Cursor - Setup for Cursor
• Windsurf - Setup for Windsurf
• Roo Code - Setup for Roo Code
• Generic MCP Client - Any MCP-compatible editor

Development

• Contributing - How to contribute
• Development Setup - Set up local development
• Architecture - System architecture overview
• API Reference - Complete API documentation
• Testing Guide - Writing and running tests

Troubleshooting & Support

• Common Issues - FAQ and solutions
• Troubleshooting - Debug MCP issues
• Performance Tips - Optimize MCP performance
• Error Codes - Error code reference

Resources

• Examples - Real-world usage examples
• Recipes - Common workflow recipes
• Best Practices - Recommended patterns
• Changelog - Version history
• Roadmap - Future plans

---

🚀 Quick Links

Tool	Description	npm Package
Smart Reviewer	AI-powered code review	@j0kz/smart-reviewer-mcp
Test Generator	Automated test generation	@j0kz/test-generator-mcp
Architecture Analyzer	Architecture analysis	@j0kz/architecture-analyzer-mcp
Security Scanner	Security vulnerability scanning	@j0kz/security-scanner-mcp
API Designer	API design and generation	@j0kz/api-designer-mcp
DB Schema Designer	Database schema design	@j0kz/db-schema-mcp
Doc Generator	Documentation generation	@j0kz/doc-generator-mcp
Refactor Assistant	Code refactoring	@j0kz/refactor-assistant-mcp

---

🎯 What are MCP Agents?

MCP Agents is a suite of 8 professional-grade tools that extend AI code editors with powerful capabilities:

Core Features

✅ Code Quality

• Smart code review with auto-fixes
• Architecture analysis and dependency graphs
• Automated test generation

✅ Security

• Vulnerability scanning (OWASP Top 10)
• Secret detection and hardcoded credentials
• Dependency security auditing

✅ Design Tools

• API design (REST, GraphQL, OpenAPI)
• Database schema design (PostgreSQL, MySQL, MongoDB)
• Mock server generation

✅ Productivity

• Automatic documentation generation
• Code refactoring assistance
• Design pattern application

✅ Integration

• Modular architecture with shared utilities
• Pipeline and workflow orchestration
• Event-driven communication

---

🏁 Getting Started in 3 Steps

Step 1: Install

# Install globally
npm install -g @j0kz/smart-reviewer-mcp @j0kz/test-generator-mcp

# Or use npx (no installation)
npx @j0kz/smart-reviewer-mcp

Step 2: Configure

Add to your MCP client configuration (e.g., Claude Code, Cursor):

{
  "mcpServers": {
    "smart-reviewer": {
      "command": "npx",
      "args": ["-y", "@j0kz/smart-reviewer-mcp"]
    },
    "test-generator": {
      "command": "npx",
      "args": ["-y", "@j0kz/test-generator-mcp"]
    }
  }
}

Step 3: Use

In your AI editor:

Review the file src/index.ts and suggest improvements

The AI will automatically use the Smart Reviewer MCP to provide detailed code analysis!

---

💡 Example Workflows

Workflow 1: Code Quality Pipeline

1. Ask AI to analyze architecture → Architecture Analyzer runs
2. Ask AI to review code quality → Smart Reviewer runs
3. Ask AI to generate tests → Test Generator runs
4. Ask AI to refactor issues → Refactor Assistant runs

Workflow 2: API Development

1. Describe your API → API Designer generates OpenAPI spec
2. Design database → DB Schema Designer creates schema
3. Generate mock server → API Designer creates implementation
4. Add tests → Test Generator creates test suite

Workflow 3: Security Audit

1. Scan for vulnerabilities → Security Scanner analyzes code
2. Generate security tests → Test Generator creates security tests
3. Document findings → Doc Generator creates report
4. Fix issues → Refactor Assistant suggests fixes

---

🔗 External Resources

• GitHub Repository - Source code
• npm Organization - Published packages
• Issue Tracker - Bug reports and features
• MCP Protocol - Official MCP documentation

---

🤝 Community

• 🐛 Report a Bug
• 💡 Request a Feature
• 📖 Improve Documentation
• 🤝 Contributing Guide

---

📄 License

This project is licensed under the MIT License.

---

Get Started | Browse Tools | View Examples | Get Help

Made with ❤️ by j0KZ