
Mcp Filesystem
io.github.Digital-Defiance由 GitHub 帳號 Digital-Defiance 發布v0.1.9更新於 Oct 24, 2026
Advanced filesystem operations with strict security boundaries for AI agents
概覽
本機 MCP 伺服器,為 AI 助理提供限定在工作區內的進階檔案操作,例如批次操作、搜尋、監看、校驗碼與磁碟分析。
- 可以做什麼
- 以原子方式執行多個檔案操作並支援回復,在工作區內遞迴複製、同步目錄、原子替換檔案並建立符號連結。即時監看目錄變更、取得累積的事件並停止監看工作階段。依名稱、內容或中繼資料搜尋檔案,並建立可搜尋索引以加快查找。計算並驗證 MD5、SHA-1、SHA-256 或 SHA-512 校驗碼以確認檔案完整性。分析磁碟用量,找出大型檔案與目錄大小。
- 適用情境
- 當助理需要在專案工作區內進行超出簡單讀寫的檔案管理時適用:原子批次修改、遞迴複製、內容搜尋、變更監看、完整性驗證或磁碟用量分析,且所有操作都限制在一個設定的根目錄內。
- 執行需求
- 以本機 stdio 程序執行,可從 npm 套件或 VS Code 擴充功能安裝。npm 套件需要 Node.js。必須將 WORKSPACE_ROOT 環境變數設為絕對路徑,所有操作都限制在該目錄內。未宣告身分驗證。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Mcp Filesystem,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
🚀 AI Capability Extension Suite
What if AI agents could actually see, debug, and control your development environment?
We've built the most comprehensive suite of MCP servers that give AI agents superpowers they've never had before. This isn't just another tool collection—it's a paradigm shift that transforms AI assistants from code generators into intelligent development partners with runtime visibility, system control, and physical world access.
📝 Note: All packages have been split into individual Git submodules with their own repositories for better maintainability and independent versioning. Each package now has its own dedicated repository under the Digital-Defiance organization.
📦 Quick Index
🐛 MCP ACS Debugger
25+ debugging tools for AI agents | VS Code Extension | NPM | Docker
- ✅ VS Code Extension with GitHub Copilot integration
- ✅ 94.53% test coverage, 1,059 tests
- ✅ Performance profiling, hang detection, advanced breakpoints
- 🎯 Kiro Superpower in development - Enhanced AI debugging workflows
📸 MCP ACS Screenshot
Visual UI capture and analysis | VS Code Extension | NPM | Docker
- ✅ Full screen, window, and region capture
- ✅ PII masking with OCR integration
- ✅ 267 tests, cross-platform support
- 🎯 Kiro Superpower in development - AI-powered visual analysis
⚙️ MCP ACS Process
Enterprise-grade process management | VS Code Extension | NPM | Docker
- ✅ 12 process management tools
- ✅ 6 layers of security validation
- ✅ Resource monitoring and service management
- 🎯 Kiro Superpower in development - Intelligent process orchestration
🎯 Akira
Spec-driven development for GitHub Copilot | Repository
- ✅ EARS-compliant requirements engineering
- ✅ Property-based testing integration
- ✅ Structured Requirements → Design → Tasks → Execution workflow
- ✅ MCP-powered persistent context across chat sessions
🎯 Now Available on VS Code Marketplace
⚡ Install the VS Code Extension →
Our flagship MCP ACS Debugger is now available as a native VS Code extension, bringing professional-grade debugging capabilities directly to your editor with zero configuration required.
Why developers love it:
- ✅ One-click installation from VS Code Marketplace
- ✅ GitHub Copilot integration for AI-powered debugging
- ✅ 25+ debugging tools accessible to AI agents
- ✅ Zero configuration - works immediately after install
- ✅ Enterprise-grade quality with 94.53% test coverage
- ✅ 1,059 passing tests
🤔 The Problem We're Solving
AI agents today are powerful but blind:
- ❌ Can't see what code actually does when it runs
- ❌ Can't capture your screen or record demonstrations
- ❌ Can't manage files beyond basic read/write
- ❌ Can't control processes or applications
- ❌ Can't interact with your actual development environment
Result: You're stuck doing manual work that AI should handle.
🎯 What We've Built: The Complete Solution
The AI Capability Extension Suite provides 5 comprehensive MCP servers that give AI agents professional-grade capabilities, plus Akira:
🐛 1. MCP ACS Debugger
The most comprehensive debugging interface for AI agents - our flagship product
Repositories: Core | Server | VS Code Extension
[VS Code Extension] [VS Code Installs] [VS Code Rating] [NPM Package] [Docker Image] [Test Coverage] [Tests]
✨ Now available as a VS Code extension! Install from Marketplace →
The Problem: AI agents were blind to runtime behavior. They could read your code and suggest fixes, but couldn't see what was actually happening when your code ran. Debugging remained a frustratingly manual process.
The Solution: AI agents can now debug like senior developers—setting breakpoints, inspecting variables, profiling performance, and detecting infinite loops in real-time. Available as both a standalone MCP server and a native VS Code extension with GitHub Copilot integration.
🎨 VS Code Extension Features
Zero-Configuration Setup:
- Install from VS Code Marketplace with one click
- Automatic MCP server integration
- No manual configuration required
- VS Code extension works with any language via Debug Adapter Protocol
- Standalone MCP server works with Node.js/JavaScript via Chrome DevTools Protocol
GitHub Copilot Integration:
- AI-powered debugging assistance in your editor
- Copilot can access debugging context and tools
- Natural language debugging commands
- Intelligent breakpoint suggestions
Native IDE Integration:
- Language Server Protocol (LSP) for code intelligence
- Debug Adapter Protocol (DAP) for seamless debugging
- Hover providers for variable inspection
- Code lens for breakpoint management
- Integrated debugging UI
Professional Debugging Workflow:
- Set breakpoints with right-click context menu
- Step through code with keyboard shortcuts
- Inspect variables in hover tooltips
- View call stack in debug panel
- Profile performance without leaving editor
Language Support:
- VS Code Extension: Multi-language support via Debug Adapter Protocol
- JavaScript/TypeScript, Python, Java, C/C++, Go, Rust, PHP, Ruby, and more
- Test Frameworks: Jest, Mocha, Vitest, pytest, JUnit, go test, cargo test
- Frameworks: React, Vue, Angular, Django, Spring Boot, and more
- Standalone MCP Server: Node.js/JavaScript only via Chrome DevTools Protocol
- Full TypeScript support with source maps
- Test Frameworks: Jest, Mocha, Vitest
- Frameworks: Express, Nest.js, React (Node.js SSR), and more
🔥 Why This Changes Everything
For Developers:
- "Debug this for me" becomes reality—AI investigates and fixes runtime issues
- Instant performance insights—AI identifies bottlenecks and memory leaks automatically
- Intelligent test debugging—AI debugs failing tests and suggests precise fixes
- Proactive hang detection—Never lose time to infinite loops again
For AI Agents:
- Runtime visibility—See what's actually happening when code executes
- Interactive debugging—Set breakpoints, step through code, inspect state
- Performance analysis—Profile CPU, memory, and execution timelines
- Intelligent problem solving—Combine static analysis with runtime behavior
🛠️ 25+ Professional Debugging Tools
Core Debugging (17 tools):
- 🚀 Session management (start, stop with clean shutdown)
- 🎯 Breakpoint operations (set, remove, toggle, list with conditional logic)
- ▶️ Execution control (continue, step over/into/out, pause)
- 🔍 Variable inspection (evaluate expressions, inspect objects, watch variables)
- 🗺️ Call stack navigation (get stack, switch frames)
- ⚠️ Hang detection (intelligent infinite loop identification)
Advanced Breakpoints (4 tools):
- 📝 Logpoints - Non-breaking observation with variable interpolation
- 🚨 Exception breakpoints - Break on caught/uncaught exceptions with filtering
- 🎯 Function breakpoints - Break on function entry with regex matching
- 🔢 Hit count conditions - Break after N hits or every Nth hit
Performance Profiling (4 tools):
- 🔥 CPU profiling - Real-time performance analysis with flame graphs
- 🧠 Memory profiling - Heap snapshots and leak detection
- 📉 Performance metrics - Timeline analysis and regression detection
- 📊 Resource monitoring - Track CPU, memory, and execution patterns
🏆 What Makes This Different
Comparison with Other Solutions:
Key Differentiators:
- 25+ tools vs basic breakpoint/step operations in alternatives
- Performance profiling (CPU, memory, timeline) - unique in MCP ecosystem
- Hang detection with infinite loop identification - no other MCP server has this
- Advanced breakpoint types (logpoints, exception, hit count, function)
- Enterprise security (authentication, rate limiting, PII masking, audit logging)
- Production readiness (graceful shutdown, circuit breakers, retry logic)
- Multi-language support via VS Code's Debug Adapter Protocol
- Source map support for TypeScript and transpiled languages
- Test framework integration (Jest, Mocha, Vitest, pytest, JUnit, go test, cargo test)
- 94.53% test coverage with 1,059 tests (most MCP servers have minimal testing)
- Property-based testing with 22 correctness properties
- Load testing with 100+ concurrent sessions
- Multiple deployment options (VS Code extension, NPM, Docker, binaries)
- Native VS Code integration with LSP/DAP protocols
- GitHub Copilot integration for AI-powered debugging
📊 Enterprise-Grade Quality
Most MCP servers are hobby projects. We've built enterprise software:
- 94.53% line coverage exceeding 90% enterprise target ✅
- 83.45% branch coverage approaching 85% target
- 1,059 tests with 99.81% pass rate
- Zero skipped tests ✅
- 22 correctness properties verified with fast-check
- Load testing (100+ concurrent debug sessions)
- Chaos testing (random failures, network issues)
- Security testing (authentication bypass attempts)
- Performance benchmarks (sub-100ms response times)
- Compatibility testing (Node.js 16-22, TypeScript 4.x-5.x)
🎮 Real-World Use Cases
"AI, debug this failing test"
"AI, find the performance bottleneck"
"AI, why is my app hanging?"
"AI, debug this Node.js issue"
🚀 Get Started
Option 1: VS Code Extension (Recommended for VS Code users)
Features:
- ✅ Zero configuration - Works out of the box
- ✅ GitHub Copilot integration - AI-powered debugging assistance
- ✅ Native VS Code debugging - Seamless IDE integration
- ✅ Language Server Protocol - Smart code intelligence
- ✅ Debug Adapter Protocol - Full debugging capabilities
Option 2: Standalone MCP Server (For other AI agents)
Option 3: From Source
📚 Documentation:
- 👉 VS Code Extension Guide
- 👉 Complete debugger documentation
- 👉 Production status report
- 👉 MCP ACS Debugger Server Repository
- 👉 MCP ACS Debugger Core Repository
- 👉 VS Code Extension Repository
📦 Installation & Usage
VS Code Extension (Recommended for VS Code users):
-
Install from Marketplace:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search for "MCP ACS Debugger"
- Click Install
- Or visit: https://marketplace.visualstudio.com/items?itemName=digitaldefiance.ts-mcp-debugger
-
Start Debugging:
- VS Code extension: Open any source code file
- Standalone MCP server: Open JavaScript or TypeScript file
- Set breakpoints by clicking in the gutter
- Press F5 to start debugging
- Use GitHub Copilot to ask debugging questions
-
Use with Copilot:
Standalone MCP Server (For other AI agents):
-
Install globally:
-
Configure your AI agent:
-
Use with your AI agent:
📸 2. MCP ACS Screenshot
Transform AI agents from code readers into visual UI experts and documentation partners
Repositories: MCP ACS Screenshot | VS Code Extension
[VS Code Extension] [VS Code Installs] [VS Code Rating] [NPM Package] [Docker Image]
✨ Now available on NPM, Docker Hub, and VS Code Marketplace!
The Problem: AI agents were blind to your actual user interface. They could read HTML/CSS and suggest improvements, but couldn't see what users actually experience—broken layouts, poor contrast, misaligned elements, or accessibility issues.
The Solution: AI agents now have visual superpowers—they can see, analyze, and document your applications like a senior UX designer. From automated documentation generation to accessibility audits, AI can now work with what users actually see.
🎨 Key Features
Screenshot Capture:
- Full screen capture with multiple format support (PNG, JPEG, WebP, BMP)
- Window-specific capture by title or ID
- Region capture with precise boundary control
- Display management - list and target specific monitors
- Quality control - adjustable compression and optimization
Privacy & Security:
- PII masking with Tesseract OCR integration
- Window exclusion - skip sensitive applications
- Secure defaults - privacy-first configuration
- Permission handling - proper system permission checks
Cross-Platform Support:
- Linux: X11 and Wayland support
- macOS: Native screenshot APIs
- Windows: Windows API integration
- Docker: Headless capture with Xvfb
🛠️ 5 Professional Screenshot Tools
screenshot_capture_full- Capture entire screen with format options (PNG, JPEG, WebP, BMP)screenshot_capture_window- Capture specific application windows by title or IDscreenshot_capture_region- Capture rectangular screen regions with precise boundariesscreenshot_list_displays- List connected displays with resolutions and scalingscreenshot_list_windows- List visible windows with titles, positions, and dimensions
Privacy & Security Features:
- PII Masking - Automatically detect and blur sensitive information (emails, phone numbers, credit cards)
- Window Exclusion - Skip password managers and authentication dialogs
- Secure Defaults - Privacy-first configuration out of the box
- Permission Handling - Proper system permission checks and user consent
📊 Enterprise-Grade Quality
- 267 tests with 100% pass rate
- Full MCP protocol compliance verified
- E2E testing (25 tests) for protocol validation
- Unit testing (242 tests) for comprehensive coverage
- VSCode extension testing (80+ tests)
- Cross-platform validation (Linux, macOS, Windows)
- Graceful failure handling for headless environments
🚀 Get Started
NPM Package:
Docker:
VSCode Extension:
- Search "MCP ACS Screenshot" in VS Code Extensions
- Or visit: https://marketplace.visualstudio.com/items?itemName=DigitalDefiance.mcp-screenshot
🎯 Revolutionary Use Cases
"AI, create professional documentation"
"AI, audit this design for accessibility"
"AI, help debug this responsive layout"
"AI, compare these two design options"
"AI, create a bug report with visuals"
🔥 What This Changes
Before: AI worked blind, relying on code descriptions
- ❌ "The layout looks broken" → AI guesses what's wrong
- ❌ "Create documentation" → AI writes generic text without visuals
- ❌ "Check accessibility" → AI can only review code, not actual contrast
- ❌ "Debug responsive design" → AI can't see actual breakpoint behavior
After: AI sees and analyzes your actual user interface
- ✅ Visual debugging - AI identifies exact pixel-level issues
- ✅ Intelligent documentation - AI creates guides with real screenshots and annotations
- ✅ Accessibility audits - AI measures actual contrast ratios and spacing
- ✅ Responsive testing - AI captures and compares different screen sizes
- ✅ Design analysis - AI evaluates visual hierarchy and user experience
- ✅ Professional bug reports - AI creates detailed reports with visual evidence
📚 Documentation:
📁 3. MCP Filesystem
Advanced file operations beyond basic I/O with strict security boundaries
Repositories: MCP Filesystem | VS Code Extension
[NPM Package] [VS Code Extension]
✨ Now available on NPM and VS Code Marketplace!
The Problem: AI agents needed advanced file operations beyond basic read/write, but without proper security boundaries, this posed significant risks—path traversal attacks, unauthorized access to system files, and exposure of sensitive credentials.
The Solution: AI agents now have enterprise-grade filesystem operations with 10 layers of security validation. From batch operations with atomic rollback to real-time directory watching, AI can now safely manage your workspace files.
🔥 Key Features
Advanced Operations:
- Batch operations - Execute multiple file operations atomically with rollback support
- Directory watching - Monitor filesystem changes in real-time with event filtering
- File search & indexing - Fast full-text search with metadata filtering
- Checksum operations - Compute and verify file integrity (MD5, SHA-1, SHA-256, SHA-512)
- Symlink management - Create and manage symbolic links within workspace boundaries
- Disk usage analysis - Analyze directory sizes and identify large files
- Directory operations - Recursive copy, sync, and atomic file replacement
Security (Defense-in-Depth):
- Workspace jail - All operations confined to configured workspace root
- 10-layer path validation - Multiple security checks prevent path traversal
- Hardcoded blocklists - System paths and sensitive files always blocked (cannot be disabled)
- Rate limiting - Configurable operation limits per minute
- Audit logging - Complete operation tracking for compliance
- Platform-specific security - Automatic OS-specific boundary enforcement
🛠️ 12 Professional Filesystem Tools
fs_batch_operations- Execute multiple operations atomically with rollbackfs_watch_directory- Monitor directories for real-time changesfs_get_watch_events- Retrieve accumulated filesystem eventsfs_stop_watch- Stop watch sessions and clean up resourcesfs_search_files- Search by name, content, or metadatafs_build_index- Build searchable index for fast searchingfs_create_symlink- Create symbolic links within workspacefs_compute_checksum- Compute file checksums for integrity verificationfs_verify_checksum- Verify file checksums match expected valuesfs_analyze_disk_usage- Analyze disk usage and identify large filesfs_copy_directory- Recursively copy directories with optionsfs_sync_directory- Sync directories by copying only newer/missing files
🚀 Get Started
NPM Package:
VS Code Extension:
- Search "MCP ACS Filesystem" in VS Code Extensions
- Or visit: https://marketplace.visualstudio.com/items?itemName=DigitalDefiance.mcp-acs-filesystem
🎯 Revolutionary Use Cases
"AI, backup all my TypeScript files"
"AI, watch for changes and rebuild"
"AI, find all TODOs in the codebase"
"AI, verify file integrity"
"AI, analyze disk usage"
📚 Documentation:
- 👉 MCP Filesystem Documentation
- 👉 VS Code Extension Documentation
- 👉 Security Documentation
- 👉 Docker Deployment Guide
⚙️ 4. MCP ACS Process
Enterprise-grade process management with strict security boundaries
Repositories: MCP ACS Process | VS Code Extension
[VS Code Extension] [VS Code Installs] [VS Code Rating] [NPM Package] [Docker Image]
✨ Now available on NPM, Docker Hub, and VS Code Marketplace!
The Problem: AI agents couldn't safely manage system processes. They needed to run commands, monitor resources, and manage services, but without proper security boundaries, this posed significant risks—command injection, resource exhaustion, and privilege escalation.
The Solution: AI agents now have enterprise-grade process management with 6 layers of security validation. From launching processes with resource limits to managing long-running services with auto-restart, AI can now safely orchestrate your development environment.
🔥 Key Features
Process Management:
- Process launching with arguments and environment variables
- Resource monitoring - Track CPU, memory, threads, and I/O in real-time
- Output capture - Separate stdout and stderr streams
- Process termination - Graceful (SIGTERM) and forced (SIGKILL) with timeout escalation
- Interactive processes - Send stdin input and retrieve buffered output
- Timeout management - Automatic termination after specified duration
Service Management:
- Long-running services with auto-restart capabilities
- Health checks - Periodic validation of service health
- Restart policies - Configurable retry limits and backoff strategies
- Service lifecycle - Start, stop, restart, and monitor services
Process Groups:
- Group management - Organize related processes
- Pipeline creation - Chain processes with stdout/stdin piping
- Batch operations - Terminate entire groups at once
Security (Defense-in-Depth):
- Executable allowlist - Only pre-approved executables can run
- Argument validation - Prevent command injection attacks
- Environment sanitization - Remove dangerous environment variables
- Resource limits - CPU, memory, and time constraints
- Privilege prevention - Block setuid executables and privilege escalation
- Audit logging - Complete operation tracking for compliance
🛠️ 12 Professional Process Tools
process_start- Launch processes with arguments, environment, and resource limitsprocess_terminate- Graceful or forced termination with timeout escalationprocess_get_stats- Real-time CPU, memory, thread, and I/O statisticsprocess_send_stdin- Send input to interactive processesprocess_get_output- Retrieve captured stdout and stderrprocess_list- List all managed processes with statusprocess_get_status- Detailed process state and uptimeprocess_create_group- Create process groups and pipelinesprocess_add_to_group- Add processes to groupsprocess_terminate_group- Terminate all processes in a groupprocess_start_service- Start long-running services with auto-restartprocess_stop_service- Stop services and disable auto-restart
🔒 Enterprise Security
6 Layers of Security Validation:
-
Executable Allowlist - Only approved executables can be launched
- Supports absolute paths, basenames, and glob patterns
- Blocks shell interpreters by default (bash, sh, cmd.exe)
- Prevents setuid executable execution
-
Argument Validation - Prevents command injection
- Validates all command-line arguments
- Blocks shell metacharacters and injection patterns
- Sanitizes special characters
-
Environment Sanitization - Removes dangerous variables
- Strips LD_PRELOAD, LD_LIBRARY_PATH
- Removes privilege escalation vectors
- Validates environment variable names and values
-
Resource Limits - Prevents resource exhaustion
- CPU percentage limits (per-process)
- Memory limits (MB)
- CPU time limits (seconds)
- Automatic termination on limit exceeded
-
Privilege Prevention - No privilege escalation
- Blocks sudo, su, pkexec
- Prevents setuid executable execution
- Enforces least-privilege principle
-
Audit Logging - Complete operation tracking
- Logs all process operations
- Records security violations
- Tracks resource usage
- Compliance-ready audit trail
📊 Quality Metrics
- Comprehensive testing with unit, integration, and E2E tests
- Security-first design with defense-in-depth validation
- Production-ready with graceful error handling
- Cross-platform support (Linux, macOS, Windows)
- Docker deployment with secure defaults
🎯 Revolutionary Use Cases
"AI, run my build and monitor resources"
"AI, start my development services"
"AI, create a data processing pipeline"
"AI, debug this hanging process"
"AI, run tests with timeout"
🚀 Get Started
Docker (Recommended):
NPM:
Configuration Example:
📚 Documentation:
- 👉 Complete process management documentation
- 👉 Security implementation guide
- 👉 Docker deployment guide
- 👉 API reference and examples
🏗️ Architecture: Built for the AI Era
Multi-Platform Integration
Integration Paths
1. VS Code Extension (Native Integration)
- Language Server Protocol (LSP) for code intelligence
- Debug Adapter Protocol (DAP) for debugging
- GitHub Copilot integration for AI assistance
- Zero configuration required
2. MCP Server (Universal Integration)
- Model Context Protocol for AI agent communication
- Works with Kiro, Amazon Q, Claude Desktop, and other MCP clients
- Flexible deployment (NPM, Docker, binaries)
- Configurable via JSON
🎮 Revolutionary Use Cases
🤖 "AI, debug and fix this issue"
📸 "AI, document this feature"
🎥 "AI, create a demo video"
📁 "AI, organize my project files"
📦 Package Structure
🐛 Debugging Capabilities
- mcp-debugger-core - Core debugging engine with Chrome DevTools Protocol integration
- mcp-debugger-server - MCP server with 25+ professional debugging tools
- Breakpoints, variable inspection, execution control
- Performance profiling (CPU, memory, timeline)
- Hang detection and infinite loop identification
- TypeScript source map support
- Enterprise security and compliance features
- 94.53% test coverage with 1,059 tests
- See DEBUGGER-README.md for full details
🖥️ System Capabilities
- mcp-screenshot - Screen capture and image operations
- mcp-process - Process and application management with enterprise security
- mcp-recording - Screen recording and video operations (Planned)
- mcp-filesystem - Advanced file system operations (Planned)
🎨 VS Code Extensions
- vscode-mcp-debugger - VS Code extension for MCP debugging
- vscode-mcp-screenshot - VS Code extension for screenshot capture
🚀 Getting Started
Prerequisites
- Node.js 18+
- Yarn (workspace support)
- TypeScript 5+
Installation
Quick Start: MCP ACS Debugger
📋 Development
Build Commands
Test Commands
Lint Commands
🏆 Production Status & Distribution
✅ MCP ACS Debugger
Distribution Channels:
- ✅ VS Code Marketplace - Native extension with Copilot integration
- ✅ NPM Registry - Global installation via npm
- ✅ Docker Hub - Containerized deployment
- ✅ GitHub Releases - Standalone binaries for all platforms
- � [MCP Registry - Submission in progress for official Model Context Protocol registry
Quality Metrics:
- 25+ professional debugging tools for AI agents
- Enterprise-grade security, compliance, and observability
- 94.53% test coverage exceeding industry standards (target: 90%)
- 83.45% branch coverage approaching target (target: 85%)
- 1,059 tests with 99.81% pass rate (1,050 passed, 2 flaky, 7 skipped)
- Production-ready with graceful shutdown, circuit breakers, retry logic
- Cross-platform support (Linux, macOS, Windows)
- Node.js compatibility tested on versions 16, 18, 20, 22
- TypeScript compatibility tested on versions 4.x and 5.x
Enterprise Features:
- 🔒 Security: Authentication, rate limiting, PII masking, audit logging
- 📊 Observability: Structured logging, metrics collection, health checks
- 🚀 Performance: CPU/memory profiling, performance timeline analysis
- 🛡️ Reliability: Circuit breakers, retry logic, graceful shutdown
- 📈 Scalability: Load tested with 100+ concurrent debug sessions
Documentation:
- 👉 VS Code Extension Guide
- 👉 Complete debugger documentation
- 👉 Production status report
- 👉 Installation guide
- 👉 API reference
🛠️ System Capabilities
- mcp-debugger: 25+ debugging tools with performance profiling, hang detection, advanced breakpoints
- mcp-screenshot: Screenshot capture with multiple formats (PNG, JPG, WebP)
- mcp-process: Process management with enterprise security
- mcp-recording: Screen recording with video encoding and frame extraction - Planned
- mcp-filesystem: Advanced file operations beyond basic read/write - Planned
📚 Documentation
Getting Started
- VS Code Extension Guide - Installation and usage for VS Code
- Quick Start Guide - Get up and running in 5 minutes
- Configuration Guide - Customize for your workflow
- Troubleshooting Guide - Common issues and solutions
Main Documentation
- README.md - This file (suite overview)
- DEBUGGER-README.md - Complete debugger documentation
- DEBUGGER-STATUS.md - Production readiness report
- MIGRATION-SUMMARY.md - Migration documentation
- MIGRATION-COMPLETE.md - Migration completion guide
Debugger Specs & Tasks
- .kiro-debugger/specs/ - Complete specifications
- .kiro-debugger/specs/mcp-debugger-tool/requirements.md - EARS-formatted requirements
- .kiro-debugger/specs/mcp-debugger-tool/design.md - Architecture and design
- .kiro-debugger/specs/mcp-debugger-tool/tasks.md - Detailed task breakdown
Package Documentation
- mcp-debugger-core - Core debugging engine
- mcp-debugger-server - MCP server
- mcp-screenshot - Screenshot capture server
- mcp-filesystem - Filesystem operations server
- mcp-process - Process management server
- mcp-recording - Recording and playback server
- vscode-mcp-debugger - VS Code debugging extension
- vscode-mcp-screenshot - VS Code screenshot extension
API Reference
- MCP Tools Reference - All 25+ debugging tools
- CDP Protocol Reference - Chrome DevTools Protocol integration
- LSP/DAP Reference - Language Server and Debug Adapter protocols
🤝 Contributing
We welcome contributions! This project follows a spec-driven development approach:
- Requirements documented in EARS format
- Design includes formal correctness properties
- Implementation follows detailed task plans
- Testing with property-based tests and comprehensive coverage
- Quality gates - all tests must pass before merging
How to Contribute
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes with tests
- Ensure all tests pass (
yarn test) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
👥 Team
Digital Defiance
- 📧 Email: [email protected]
- 🚨 Security: SECURITY.md
- 🔗 LinkedIn: Digital Defiance
- 🌐 Website: digitaldefiance.org
📄 License
MIT License - See LICENSE for details
🎉 Join the Revolution
We're building the foundation for AI-powered development workflows.
By giving AI agents professional-grade capabilities, we're creating a future where:
- ✅ Bugs are investigated automatically while you focus on features
- ✅ Documentation is generated from actual system behavior
- ✅ Demos are created with a single command
- ✅ Code is organized following best practices automatically
- ✅ Junior developers have access to senior-level expertise
This isn't just a tool suite—it's the future of software development.
🚀 Quick Start Options
For VS Code Users (Recommended)
For Other AI Agents (Kiro, Amazon Q, Claude)
For Contributors & Developers
📊 Project Statistics
- Total Packages: 10 (5 production, 5 in development)
- Total Tests: 1,059 tests across all packages
- Test Pass Rate: 99.81% (1,050 passed, 2 flaky, 7 skipped)
- Code Coverage: 94.53% lines, 83.45% branches
- Lines of Code: 15,000+ lines of production code
- Documentation: 10,000+ lines of comprehensive documentation
- Supported Platforms: Linux, macOS, Windows
- Node.js Versions: 16, 18, 20, 22
- TypeScript Versions: 4.x, 5.x
🌟 Why Choose This Suite?
1. Production-Ready Quality
- Enterprise-grade testing with 94.53% coverage
- Property-based testing with 22 correctness properties
- Load testing with 100+ concurrent sessions
- Chaos testing for reliability validation
- Security testing for vulnerability detection
2. Multiple Integration Options
- Native VS Code extension with zero configuration
- Standalone MCP server for universal AI agent support
- Docker containers for easy deployment
- Standalone binaries for no-install usage
3. Comprehensive Feature Set
- 25+ debugging tools (most comprehensive in MCP ecosystem)
- Performance profiling (CPU, memory, timeline)
- Advanced breakpoint types (logpoints, exception, hit count, function)
- Enterprise security (authentication, rate limiting, PII masking)
- Production readiness (graceful shutdown, circuit breakers, retry logic)
4. Active Development & Support
- Regular updates and new features
- Responsive issue tracking on GitHub
- Comprehensive documentation and examples
- Community-driven development
5. Open Source & Extensible
- MIT License - use freely in any project
- Well-documented codebase for contributions
- Modular architecture for easy extension
- Active community contributions welcome
💬 Community & Support
Get Help:
Stay Updated:
- ⭐ Star this repository for updates
- 👀 Watch for new releases
- 🐦 Follow us on social media (coming soon)
- 📰 Subscribe to our newsletter (coming soon)
Contribute:
- 🔧 Submit pull requests
- 🐛 Report bugs and issues
- 💡 Suggest new features
- 📝 Improve documentation
- 🧪 Add test coverage
🏅 Recognition & Achievements
VS Code Marketplace
- ✅ Published Extension - MCP ACS TypeScript Debugger
- 🎯 Zero Configuration - Works immediately after installation
- 🤖 Copilot Integration - First MCP debugger with native Copilot support
- 🌍 Multi-Language - VS Code extension supports all languages; MCP server supports Node.js/JavaScript
- 📦 Professional Quality - Enterprise-grade extension with comprehensive testing
Distribution Channels
- ✅ VS Code Marketplace - Native extension for VS Code users
- ✅ NPM Registry - Global installation via
npm install -g - ✅ Docker Hub - Containerized deployment for production
- ✅ GitHub Releases - Standalone binaries for all platforms
- 🔄 MCP Registry - Official Model Context Protocol registry (submission in progress)
- 🔄 Homebrew - macOS package manager (formula in progress)
Quality Metrics
- 🏆 94.53% Test Coverage - Exceeding industry standard of 90%
- ✅ 1,059 Tests - Comprehensive test suite with 99.81% pass rate
- 🔒 Enterprise Security - Authentication, rate limiting, PII masking, audit logging
- 📊 Production Ready - Graceful shutdown, circuit breakers, retry logic
- 🌍 Cross-Platform - Linux, macOS, Windows support
- 🔧 Multi-Version - Node.js 16-22, TypeScript 4.x-5.x compatibility
Community Impact
- Model Context Protocol Ecosystem - Contributing to the MCP standard
- Open Source Excellence - MIT License, well-documented codebase
- Community Driven - Built with feedback from developers worldwide
- Active Development - Regular updates and new features
- Responsive Support - GitHub issues, discussions, and email support
🎯 Ready to Get Started?
For VS Code Users (Recommended)
Install the extension in 3 ways:
-
From VS Code:
- Open Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search "MCP ACS Debugger"
- Click Install
-
From Command Line:
-
From Marketplace:
- Visit VS Code Marketplace
- Click "Install"
For Other AI Agents
Choose your installation method:
For Contributors
📊 Installation Statistics
[VS Code Extension] [VS Code Installs] [VS Code Rating]
[GitHub Release] [GitHub Downloads]
[License] [Test Coverage] [Tests]
🔗 Individual Package Repositories
Core MCP Servers
- mcp-debugger-core - Core debugging engine with Chrome DevTools Protocol
- mcp-debugger-server - MCP debugging server with 25+ tools
- mcp-screenshot - Screenshot capture server with PII masking
- mcp-filesystem - Advanced filesystem operations server
- mcp-process - Process management and monitoring server
- mcp-recording - Screen recording and playback server
VS Code Extensions
- vscode-mcp-debugger - VS Code debugging extension with Copilot integration
- vscode-mcp-screenshot - VS Code screenshot extension with LSP features
- vscode-mcp-acs-process - VS Code process management extension with LSP features
Main Links
- Homepage: digitaldefiance.org
- Main Repository: ai-capabilities-suite
- Organization: Digital-Defiance
- NPM Packages: @ai-capabilities-suite
- Docker Hub: digitaldefiance
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Built with ❤️ by the Digital Defiance team using Amazon Kiro, TypeScript, and the Model Context Protocol
Ready to give your AI agent superpowers? Install now! 🚀
🔧 Kiro MCP Configuration
Quick Setup for Kiro Users
Configure Kiro to use the AI Capability Extension Suite MCP servers by editing ~/.kiro/settings/mcp.json:
MCP ACS Process Configuration
Create mcp-process-config.json in your project directory or home directory:
Note: The config file requirement for mcp-process will be removed in an upcoming release, making it optional with sensible defaults.
Prerequisites
For Linux users (Ubuntu/Debian):
For macOS users:
For Windows users:
Alternative: Global Installation
If you prefer global installation over npx:
Verification
After configuration, restart Kiro and verify the servers are connected:
Troubleshooting
Connection issues:
- Ensure Node.js 18+ is installed:
node --version - Check Python setuptools:
python3 -c "import setuptools" - Verify packages are published:
npm view @ai-capabilities-suite/mcp-screenshot
Native dependency errors:
- Install build tools (see Prerequisites above)
- Clear npm cache:
npm cache clean --force - Reinstall with:
npm install -g --force @ai-capabilities-suite/mcp-screenshot
Config file not found:
- Use absolute path to config file in mcp.json
- Verify file exists:
ls -la ./mcp-process-config.json - Check JSON syntax:
cat mcp-process-config.json | jq
🎯 Akira
Spec-driven development powered by GitHub Copilot and MCP
Repository: Akira
The Problem: Traditional AI-assisted development lacks structure—requirements are vague, designs are inconsistent, and implementation happens without proper planning. AI agents generate code without understanding the full context or ensuring correctness.
The Solution: Akira brings professional software engineering methodology to AI-assisted development. Using the Easy Approach to Requirements Syntax (EARS) and INCOSE quality rules, Akira guides AI through a structured workflow: Requirements → Design → Tasks → Execution. With Model Context Protocol (MCP) integration, specifications persist across chat sessions, ensuring consistency and enabling property-based testing.
🎨 Key Features
Structured Spec-Driven Workflow:
- Requirements Phase - Generate EARS-compliant requirements with INCOSE validation
- Design Phase - Create technical designs with correctness properties
- Tasks Phase - Generate actionable implementation plans with proper hierarchy
- Execution Phase - Execute tasks with full context from requirements and design
Advanced Requirements Engineering:
- EARS Compliance - All requirements follow one of six EARS patterns
- INCOSE Quality Rules - Automatic validation against semantic quality standards
- Glossary Management - Automatic extraction and definition of technical terms
- User Story Structure - Consistent format with 2-5 acceptance criteria per requirement
Property-Based Testing Integration:
- Correctness Properties - Generate testable properties from acceptance criteria
- Universal Quantification - Properties formatted with explicit "For any" statements
- Round-Trip Properties - Automatic detection for parsing/serialization requirements
- Test Library Integration - Support for fast-check and other PBT libraries
Model Context Protocol (MCP) Integration:
- Persistent Context - Spec documents remain accessible across chat sessions
- Structured Tools - Programmatic access to spec operations via MCP tools
- State Management - Track workflow progress and task completion
- File Operations - Read, write, and update spec documents through MCP
🛠️ Workflow Phases
- Requirements - Generate user stories with EARS patterns and INCOSE validation
- Design - Create technical design with correctness properties for PBT
- Tasks - Generate actionable implementation plan with 2-level hierarchy
- Execution - Execute tasks with full context loading and status tracking
🎯 Revolutionary Use Cases
"AI, create a spec for user authentication"
"AI, generate correctness properties"
"AI, execute the implementation plan"
🚀 Get Started
Install from VS Code:
- Search "Akira" in VS Code Extensions
- Or visit: VS Code Marketplace (Coming Soon)
Usage with GitHub Copilot:
📚 Documentation:
來源:README.md,提交 1baa41a
工具
0版本歷史
1- v0.1.9最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分