Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .agent/aidevops/mcp-integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ tools:
- Google Search Console: `GOOGLE_APPLICATION_CREDENTIALS` (service account JSON)

**Development**:
- Claude Code MCP: Claude Code automation (forked server)
- Next.js DevTools MCP
- Context7 MCP: Real-time library docs
- LocalWP MCP: WordPress database access
Expand All @@ -56,6 +57,7 @@ This document provides comprehensive setup and usage instructions for advanced M

### **⚡ Development Tools**

- **Claude Code MCP**: Run Claude Code as an MCP server for automation
- **Next.js DevTools MCP**: Next.js development and debugging assistance

### **📧 CRM & Marketing**
Expand Down Expand Up @@ -93,6 +95,17 @@ playwright-mcp --install-browsers
claude mcp add playwright npx playwright-mcp@latest
```

### **Claude Code MCP (Fork)**

```bash
# Add forked MCP server via Claude CLI
claude mcp add claude-code-mcp "npx -y github:marcusquinn/claude-code-mcp"
```

**One-time setup**: run `claude --dangerously-skip-permissions` and accept prompts.
**Upstream**: https://github.com/steipete/claude-code-mcp (revert if merged).
**Local dev (optional)**: clone the fork and swap the command to `./start.sh` for instant iteration.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The instruction for local development is a bit vague. It would be helpful to specify where the user should swap the command to make it easier for them to get started with local development. Consider clarifying that they need to edit their MCP configuration.

Suggested change
**Local dev (optional)**: clone the fork and swap the command to `./start.sh` for instant iteration.
**Local dev (optional)**: clone the fork and edit your MCP configuration (e.g., in `~/.config/opencode/opencode.json`) to use the local `./start.sh` script instead of the `npx` command for instant iteration.


### **Ahrefs MCP**

```bash
Expand Down
24 changes: 21 additions & 3 deletions .agent/scripts/generate-opencode-agents.sh
Original file line number Diff line number Diff line change
Expand Up @@ -121,12 +121,14 @@ AGENT_TOOLS = {
"Build+": {
"write": True, "edit": True, "bash": True, "read": True, "glob": True, "grep": True,
"webfetch": True, "task": True, "todoread": True, "todowrite": True,
"context7_*": True, "osgrep_*": True, "augment-context-engine_*": True, "repomix_*": True
"context7_*": True, "osgrep_*": True, "augment-context-engine_*": True, "repomix_*": True,
"claude-code-mcp_*": True
},
"AI-DevOps": {
"write": True, "edit": True, "bash": True, "read": True, "glob": True, "grep": True,
"webfetch": True, "task": True, "todoread": True, "todowrite": True,
"context7_*": True, "osgrep_*": True, "augment-context-engine_*": True, "repomix_*": True
"context7_*": True, "osgrep_*": True, "augment-context-engine_*": True, "repomix_*": True,
"claude-code-mcp_*": True
},
"Onboarding": {
"write": True, "edit": True, "bash": True, "read": True, "glob": True, "grep": True,
Expand Down Expand Up @@ -166,7 +168,8 @@ AGENT_TOOLS = {
DEFAULT_TOOLS = {
"write": True, "edit": True, "bash": True, "read": True, "glob": True, "grep": True,
"webfetch": True, "task": True,
"osgrep_*": True, "augment-context-engine_*": True
"osgrep_*": True, "augment-context-engine_*": True,
"claude-code-mcp_*": False
}

# Temperature settings (by display name, default 0.2)
Expand Down Expand Up @@ -472,6 +475,21 @@ if 'shadcn_*' not in config['tools']:
config['tools']['shadcn_*'] = False
print(" Added shadcn_* to tools (disabled globally, enabled for @shadcn subagent)")

# Claude Code MCP - forked for local automation
# Source: https://github.com/marcusquinn/claude-code-mcp
# Upstream: https://github.com/steipete/claude-code-mcp (revert if merged)
config['mcp']['claude-code-mcp'] = {
"type": "local",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

config['mcp']['claude-code-mcp'] is set unconditionally here, which will overwrite any existing user config (e.g., a local-dev ./start.sh command) every time this script runs. Consider only setting this block when the key is missing, consistent with the other MCP server sections.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

"command": ["npx", "-y", "github:marcusquinn/claude-code-mcp"],
"enabled": True
}
print(" Ensured claude-code-mcp MCP server (forked)")

# Claude Code MCP tools disabled globally (enable per-agent if needed)
if 'claude-code-mcp_*' not in config['tools']:
config['tools']['claude-code-mcp_*'] = False
print(" Added claude-code-mcp_* to tools (disabled globally, enabled for Build+/AI-DevOps)")
Comment on lines +488 to +491

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This block of code appears to be redundant and unreachable. The script already iterates over DEFAULT_TOOLS around line 425 and adds any missing tools to config['tools']. Since claude-code-mcp_* is now in DEFAULT_TOOLS, the condition 'claude-code-mcp_*' not in config['tools'] on line 487 will never be true. This block can be safely removed to improve code clarity.


# macOS Automator MCP - AppleScript and JXA automation (macOS only)
# Docs: https://github.com/steipete/macos-automator-mcp
# Note: import platform is at line 412 with other imports
Expand Down
15 changes: 14 additions & 1 deletion .agent/scripts/setup-mcp-integrations.sh
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ get_mcp_command() {
"google-search-console") echo "npx mcp-server-gsc@latest" ;;
"pagespeed-insights") echo "npx mcp-pagespeed-server@latest" ;;
"grep-vercel") echo "remote:https://mcp.grep.app" ;;
"claude-code-mcp") echo "npx -y github:marcusquinn/claude-code-mcp" ;;
"stagehand") echo "node ${HOME}/.aidevops/stagehand/examples/basic-example.js" ;;
"stagehand-python") echo "${HOME}/.aidevops/stagehand-python/.venv/bin/python ${HOME}/.aidevops/stagehand-python/examples/basic_example.py" ;;
"stagehand-both") echo "both" ;;
Expand All @@ -47,7 +48,7 @@ get_mcp_command() {
}

# Available integrations list
MCP_LIST="chrome-devtools playwright cloudflare-browser ahrefs perplexity nextjs-devtools google-search-console pagespeed-insights grep-vercel stagehand stagehand-python stagehand-both dataforseo serper"
MCP_LIST="chrome-devtools playwright cloudflare-browser ahrefs perplexity nextjs-devtools google-search-console pagespeed-insights grep-vercel claude-code-mcp stagehand stagehand-python stagehand-both dataforseo serper"

# Check prerequisites
check_prerequisites() {
Expand Down Expand Up @@ -186,6 +187,18 @@ install_mcp() {
print_info "Use 'gh_grep' tool in prompts to search GitHub code"
print_info "Example: 'use gh_grep to find examples of SST Astro components'"
;;
"claude-code-mcp")
print_info "Setting up Claude Code MCP (forked) for Claude Code automation..."
print_info "Source: https://github.com/marcusquinn/claude-code-mcp"
print_info "Upstream: https://github.com/steipete/claude-code-mcp (revert if merged)"
print_warning "Requires Claude CLI and prior acceptance of --dangerously-skip-permissions"
print_info "One-time setup: claude --dangerously-skip-permissions"
if command -v claude &> /dev/null; then
claude mcp add claude-code-mcp "$mcp_command"
fi
print_success "Claude Code MCP setup complete!"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This prints “setup complete” even if claude isn’t installed and the claude mcp add ... step never ran, which can be misleading. Consider warning and/or returning non-zero when claude is absent.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

print_info "Use 'claude_code' tool to run Claude Code tasks"
;;
"stagehand")
print_info "Setting up Stagehand AI Browser Automation MCP integration..."

Expand Down
28 changes: 27 additions & 1 deletion .wiki/MCP-Integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -242,7 +242,30 @@ bash .agent/scripts/setup-mcp-integrations.sh pagespeed

---

### Development Tools (3 servers)
### Development Tools (4 servers)

#### Claude Code MCP (Fork)

Run Claude Code as an MCP server for automation.

**Installation**:

```bash
claude mcp add claude-code-mcp "npx -y github:marcusquinn/claude-code-mcp"
```

**Upstream**: https://github.com/steipete/claude-code-mcp (revert if merged).
**Local dev (optional)**: clone the fork and point the MCP command to `./start.sh`.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The instruction for local development is a bit vague. To improve clarity for users, it would be helpful to specify how to "point the MCP command to ./start.sh". You could mention that this involves editing their specific MCP configuration file.

Suggested change
**Local dev (optional)**: clone the fork and point the MCP command to `./start.sh`.
**Local dev (optional)**: clone the fork and edit your MCP configuration (e.g., in `~/.cursor/mcp.json` or `~/.config/opencode/opencode.json`) to replace the `npx` command with the path to the local `./start.sh` script.


**One-time setup**: run `claude --dangerously-skip-permissions` and accept prompts.

**Use Cases**:

- Run Claude Code workflows from MCP clients
- Multi-step code edits via Claude Code CLI
- Reuse Claude Code toolchain in Cursor/Windsurf

---

#### Next.js DevTools MCP

Expand Down Expand Up @@ -332,6 +355,9 @@ bash .agent/scripts/setup-mcp-integrations.sh playwright
# Ahrefs
bash .agent/scripts/setup-mcp-integrations.sh ahrefs

# Claude Code MCP (fork)
bash .agent/scripts/setup-mcp-integrations.sh claude-code-mcp

# Context7
bash .agent/scripts/setup-mcp-integrations.sh context7
```
Expand Down
60 changes: 60 additions & 0 deletions configs/mcp-templates/claude-code-mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
{
"_comment": "Claude Code MCP (fork) configuration snippets for various AI tools",
"_documentation": "https://github.com/marcusquinn/claude-code-mcp",
"_upstream": "https://github.com/steipete/claude-code-mcp (revert if merged)",
"_note": "Requires Claude CLI with --dangerously-skip-permissions accepted (swap to ./start.sh for local dev)",
"_install": "npx -y github:marcusquinn/claude-code-mcp",

"opencode": {
"_file": "~/.config/opencode/opencode.json",
"_section": "mcp",
"claude-code-mcp": {
"type": "local",
"command": ["npx", "-y", "github:marcusquinn/claude-code-mcp"],
"enabled": true
}
},

"claude_code_command": "claude mcp add claude-code-mcp \"npx -y github:marcusquinn/claude-code-mcp\"",

"cursor": {
"_file": "~/.cursor/mcp.json",
"mcpServers": {
"claude-code-mcp": {
"command": "npx",
"args": ["-y", "github:marcusquinn/claude-code-mcp"]
}
}
},

"windsurf": {
"_file": "~/.codeium/windsurf/mcp_config.json",
"mcpServers": {
"claude-code-mcp": {
"command": "npx",
"args": ["-y", "github:marcusquinn/claude-code-mcp"]
}
}
},

"gemini_cli": {
"_file": "~/.gemini/settings.json",
"mcpServers": {
"claude-code-mcp": {
"command": "npx",
"args": ["-y", "github:marcusquinn/claude-code-mcp"]
}
}
},

"github_copilot": {
"_file": ".vscode/mcp.json (project root)",
"servers": {
"claude-code-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "github:marcusquinn/claude-code-mcp"]
}
}
}
}