Installation

Requirements

• Node.js >=22.7.5
• npm >=10.0.0
• A MCP-compatible host: Claude Desktop, VS Code (Copilot Chat), Cline, or any MCP client

Install Methods

npx (recommended)

No installation needed — npx downloads and runs the latest version on demand.

{
  "mcp": {
    "servers": {
      "ai-agent-guidelines": {
        "command": "npx",
        "args": ["-y", "mcp-ai-agent-guidelines@latest"]
      }
    }
  }
}

Global install

npm install -g mcp-ai-agent-guidelines

Then configure your MCP host with command: "mcp-ai-agent-guidelines" and args: [].

Docker

docker pull ghcr.io/anselmoo/mcp-ai-agent-guidelines:latest

MCP config:

{
  "mcp": {
    "servers": {
      "ai-agent-guidelines": {
        "command": "docker",
        "args": ["run", "--rm", "-i",
          "ghcr.io/anselmoo/mcp-ai-agent-guidelines:latest"]
      }
    }
  }
}

From source

git clone https://github.com/Anselmoo/mcp-ai-agent-guidelines.git
cd mcp-ai-agent-guidelines
npm ci
npm run build

Then configure your MCP host with:

{
  "mcp": {
    "servers": {
      "ai-agent-guidelines": {
        "command": "node",
        "args": ["/path/to/mcp-ai-agent-guidelines/dist/index.js"]
      }
    }
  }
}

VS Code One-Click Install

Click the button to install directly into VS Code via the MCP redirect:

Or add manually in VS Code User Settings (JSON):

{
  "mcp": {
    "servers": {
      "ai-agent-guidelines": {
        "command": "npx",
        "args": ["-y", "mcp-ai-agent-guidelines@latest"]
      }
    }
  }
}

Verify Installation

After adding the server to your MCP host, verify the tools are listed:

# Using MCP Inspector CLI
npx -y @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

You should see 20+ tools including system-design, feature-implement, task-bootstrap, etc.

Next Steps

• Quickstart — your first task with the server
• MCP Configuration — environment variables, physics skill gating, orchestration config