AMS Development MCP Servers

MCP servers for real-time development monitoring and interactive pair programming

Overview

A suite of Model Context Protocol (MCP) servers designed to enhance AI-assisted development workflows. These servers enable AI assistants like Claude Code to actively monitor development processes, inspect running applications, and participate in interactive debugging sessions.

Related MCP server: personal-mcp

Packages

This monorepo contains four interconnected MCP servers:

@ams-dev/process-manager · npm

Monitor and control development processes (nx serve, npm run, etc.)

• Start, stop, and restart processes

• Stream and filter process logs in real-time

• Send input to interactive processes

• Pattern-based monitoring for errors and warnings

@ams-dev/docker-manager · npm

Control and inspect Docker containers

• List, start, stop, and restart containers

• Execute commands inside containers

• Stream container logs

• Inspect container configuration and state

@ams-dev/dev-watcher · npm

Real-time error detection and pattern matching across all development sources

• Aggregate logs from processes and containers

• Regex pattern matching for errors and warnings

• Alert deduplication and severity classification

• Integration with browser console logs

@ams-dev/browser-inspector · npm

Browser automation, inspection, monitoring, and performance analysis using Puppeteer

• Navigate and interact with web pages (click, type, wait for elements)

• Monitor console logs and network requests in real-time

• Capture screenshots and extract page content

• Execute custom JavaScript in browser context

• Performance metrics (load times, FCP, resource counts)

• Automated accessibility audits

• Cookie and localStorage management

Quick Start

Installation

# Install all packages globally
npm install -g @ams-dev/process-manager @ams-dev/docker-manager @ams-dev/dev-watcher @ams-dev/browser-inspector

# Or use with npx (no installation required)
npx @ams-dev/process-manager

Configuration

Add to your Claude Code MCP configuration (~/.config/claude/mcp.json):

{
  "mcpServers": {
    "process-manager": {
      "command": "npx",
      "args": ["-y", "@ams-dev/process-manager"]
    },
    "docker-manager": {
      "command": "npx",
      "args": ["-y", "@ams-dev/docker-manager"]
    },
    "dev-watcher": {
      "command": "npx",
      "args": ["-y", "@ams-dev/dev-watcher"]
    },
    "browser-inspector": {
      "command": "npx",
      "args": ["-y", "@ams-dev/browser-inspector"]
    }
  }
}

Use Cases

NX Monorepo Development

Claude: "I'll start the admin and products services for you"
- Starts both services with process-manager
- Monitors for compile errors
- Reports when servers are ready

Docker-based Development

Developer: "Set up the local environment"
Claude: "Starting your database containers"
- Starts PostgreSQL and Redis containers
- Checks container health
- Reports when services are ready

Interactive Debugging

Developer: "Why is the API slow?"
Claude:
- Checks API process logs for slow queries
- Inspects PostgreSQL container logs
- Reports findings with specific line references

Development

This project uses PNPM workspaces for monorepo management.

# Clone the repository
git clone https://github.com/mastoica/vibecoding-mcp-servers.git
cd vibecoding-mcp-servers

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

Documentation

• Getting Started (coming soon)

• Installation Guide (coming soon)

• Configuration (coming soon)

• Examples (coming soon)

Requirements

• Node.js >= 18.0.0

• PNPM >= 8.0.0

• Docker (optional, for docker-manager)

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

License

MIT © mastoica

Roadmap

• Repository setup

• Process Manager MCP (v0.1.0)

• Docker Manager MCP (v0.1.0)

• Dev Watcher MCP (v0.1.0)

• Complete documentation

• CI/CD pipeline

• Publish to npm

Status: 🚧 Work in Progress - Initial development phase