@aiwerk/mcp-bridge 2.1.3 → 2.5.0

package/scripts/install-server.sh

@@ -122,8 +122,10 @@ install_dependencies() {
             echo "Pulling GitHub MCP server Docker image..."
             docker pull ghcr.io/github/github-mcp-server ;;
         linear)
-            echo "Installing @anthropic-pb/linear-mcp-server globally..."
-            npm install -g @anthropic-pb/linear-mcp-server ;;
+            local clone_dir="$HOME/.openclaw/mcp-servers/linear-mcp"
+            mkdir -p "$HOME/.openclaw/mcp-servers"
+            echo "Installing linear MCP server..."
+            npm install --prefix "$clone_dir" @anthropic-pb/linear-mcp-server ;;
         wise)
             # Clone outside plugin tree to avoid nested node_modules TS path conflicts
             local clone_dir="$HOME/.openclaw/mcp-servers/wise-mcp"
@@ -152,11 +154,11 @@ install_dependencies() {
 resolve_path_override() {
     case "$SERVER_NAME" in
         linear)
-            local npm_root; npm_root="$(npm root -g)"
-            if [ -f "$npm_root/@anthropic-pb/linear-mcp-server/dist/index.js" ]; then
-                echo "$npm_root/@anthropic-pb/linear-mcp-server/dist/index.js"
+            local lin_dir="$HOME/.openclaw/mcp-servers/linear-mcp/node_modules/@anthropic-pb/linear-mcp-server"
+            if [ -f "$lin_dir/dist/index.js" ]; then
+                echo "$lin_dir/dist/index.js"
             else
-                echo "$npm_root/@anthropic-pb/linear-mcp-server/build/index.js"
+                echo "$lin_dir/build/index.js"
             fi ;;
         wise)   echo "$HOME/.openclaw/mcp-servers/wise-mcp/dist/cli.js" ;;
         hetzner) echo "$HOME/.openclaw/mcp-servers/mcp-hetzner/dist/index.js" ;;

package/scripts/validate-recipes.sh

@@ -15,6 +15,19 @@ RED='\033[0;31m'
 GREEN='\033[0;32m'
 NC='\033[0m'
 
+echo "Validating recipe schema..."
+echo ""
+
+for recipe in "$SERVERS_DIR"/*/recipe.json; do
+  if ! npx tsx "$SCRIPT_DIR/../bin/validate-recipe.ts" "$recipe" >/dev/null; then
+    echo -e "${RED}❌ SCHEMA [$(basename "$(dirname "$recipe")")] $recipe${NC}"
+    ERRORS=$((ERRORS + 1))
+  else
+    echo -e "${GREEN}✓${NC} [$(basename "$(dirname "$recipe")")] schema valid"
+  fi
+done
+
+echo ""
 echo "Validating recipe URLs..."
 echo ""
 

package/servers/apify/recipe.json

@@ -4,7 +4,6 @@
   "name": "Apify",
   "description": "Web scraping and automation platform with 3000+ ready-made actors for data extraction, browser automation, and crawling",
   "repository": "https://github.com/apify/apify-mcp-server",
-
   "transports": [
     {
       "type": "streamable-http",
@@ -14,24 +13,38 @@
       }
     }
   ],
-
   "auth": {
     "required": true,
     "type": "bearer",
-    "envVars": ["APIFY_TOKEN"],
+    "envVars": [
+      "APIFY_TOKEN"
+    ],
     "credentialsUrl": "https://console.apify.com/settings/integrations",
     "instructions": "Copy your API token from Apify Console > Settings > Integrations."
   },
-
   "metadata": {
     "homepage": "https://apify.com/",
     "author": "Apify",
-    "tags": ["scraping", "automation", "web", "crawling", "actors"],
+    "tags": [
+      "scraping",
+      "automation",
+      "web",
+      "crawling",
+      "actors"
+    ],
     "category": "automation",
     "pricing": "byok",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "scraping",
+    "origin": "community",
+    "countries": [
+      "global"
+    ],
+    "audience": "developer",
+    "selfHosted": false,
+    "sideEffects": "read-write",
+    "authSummary": "bearer"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/atlassian/recipe.json

@@ -4,12 +4,13 @@
   "name": "Atlassian (Confluence + Jira)",
   "description": "Confluence wiki and Jira project management — search, create, and update pages and issues",
   "repository": "https://github.com/sooperset/mcp-atlassian",
-
   "transports": [
     {
       "type": "stdio",
       "command": "uvx",
-      "args": ["mcp-atlassian"],
+      "args": [
+        "mcp-atlassian"
+      ],
       "env": {
         "CONFLUENCE_URL": "${CONFLUENCE_URL}",
         "CONFLUENCE_USERNAME": "${CONFLUENCE_USERNAME}",
@@ -20,7 +21,6 @@
       }
     }
   ],
-
   "auth": {
     "required": true,
     "type": "api-key",
@@ -35,22 +35,34 @@
     "credentialsUrl": "https://id.atlassian.com/manage-profile/security/api-tokens",
     "instructions": "Create an API token at Atlassian account settings. Set CONFLUENCE_URL and JIRA_URL to your instance URLs (e.g., https://yourcompany.atlassian.net/wiki and https://yourcompany.atlassian.net)."
   },
-
   "install": {
     "method": "uvx",
     "package": "mcp-atlassian",
     "version": "latest"
   },
-
   "metadata": {
     "homepage": "https://github.com/sooperset/mcp-atlassian",
     "author": "sooperset",
-    "tags": ["wiki", "project-management", "confluence", "jira", "atlassian"],
+    "tags": [
+      "wiki",
+      "project-management",
+      "confluence",
+      "jira",
+      "atlassian"
+    ],
     "category": "productivity",
     "pricing": "byok",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "project-management",
+    "origin": "community",
+    "countries": [
+      "global"
+    ],
+    "audience": "business",
+    "selfHosted": false,
+    "sideEffects": "read-write",
+    "authSummary": "api-key"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/chrome-devtools/recipe.json

@@ -4,38 +4,52 @@
   "name": "Chrome DevTools",
   "description": "Control and inspect a live Chrome browser for automation, debugging, and performance analysis via the Chrome DevTools Protocol",
   "repository": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
-
   "transports": [
     {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "chrome-devtools-mcp@0.20.0", "--autoConnect"],
+      "args": [
+        "-y",
+        "chrome-devtools-mcp@0.20.0",
+        "--autoConnect"
+      ],
       "env": {}
     }
   ],
-
   "auth": {
     "required": false,
     "type": "none",
     "envVars": [],
     "instructions": "Requires Chrome >= 144 with remote debugging enabled at chrome://inspect/#remote-debugging. Chrome will show a permission dialog on each connection."
   },
-
   "install": {
     "method": "npx",
     "package": "chrome-devtools-mcp",
     "version": "0.20.0"
   },
-
   "metadata": {
     "homepage": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "author": "ChromeDevTools",
-    "tags": ["browser", "debugging", "automation", "devtools", "chrome"],
+    "tags": [
+      "browser",
+      "debugging",
+      "automation",
+      "devtools",
+      "chrome"
+    ],
     "category": "development",
     "pricing": "free",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "monitoring",
+    "origin": "community",
+    "countries": [
+      "global"
+    ],
+    "audience": "developer",
+    "selfHosted": true,
+    "sideEffects": "read-only",
+    "authSummary": "none"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/github/recipe.json

@@ -4,7 +4,6 @@
   "name": "GitHub",
   "description": "GitHub repository management — repos, issues, PRs, code search, and more via the official GitHub MCP server",
   "repository": "https://github.com/github/github-mcp-server",
-
   "transports": [
     {
       "type": "stdio",
@@ -22,30 +21,43 @@
       }
     }
   ],
-
   "auth": {
     "required": true,
     "type": "api-key",
-    "envVars": ["GITHUB_MCP_TOKEN"],
+    "envVars": [
+      "GITHUB_MCP_TOKEN"
+    ],
     "credentialsUrl": "https://github.com/settings/tokens",
     "instructions": "Create a Personal Access Token at GitHub Settings > Developer settings > Personal access tokens. Grant repo, issues, and pull_requests scopes."
   },
-
   "install": {
     "method": "docker",
     "image": "ghcr.io/github/github-mcp-server",
     "version": "latest"
   },
-
   "metadata": {
     "homepage": "https://github.com/github/github-mcp-server",
     "author": "GitHub",
-    "tags": ["git", "repos", "issues", "pull-requests", "code-review"],
+    "tags": [
+      "git",
+      "repos",
+      "issues",
+      "pull-requests",
+      "code-review"
+    ],
     "category": "development",
     "pricing": "byok",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "version-control",
+    "origin": "official",
+    "countries": [
+      "global"
+    ],
+    "audience": "developer",
+    "selfHosted": false,
+    "sideEffects": "read-write",
+    "authSummary": "api-key"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/google-maps/recipe.json

@@ -4,41 +4,56 @@
   "name": "Google Maps",
   "description": "Google Maps integration for places search, geocoding, directions, and distance matrix via the official MCP server",
   "repository": "https://github.com/modelcontextprotocol/servers",
-
   "transports": [
     {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-google-maps"],
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-google-maps"
+      ],
       "env": {
         "GOOGLE_MAPS_API_KEY": "${GOOGLE_MAPS_API_KEY}"
       }
     }
   ],
-
   "auth": {
     "required": true,
     "type": "api-key",
-    "envVars": ["GOOGLE_MAPS_API_KEY"],
+    "envVars": [
+      "GOOGLE_MAPS_API_KEY"
+    ],
     "credentialsUrl": "https://console.cloud.google.com/apis/credentials",
     "instructions": "Create an API key in Google Cloud Console and enable the Maps JavaScript API, Places API, Geocoding API, and Directions API."
   },
-
   "install": {
     "method": "npx",
     "package": "@modelcontextprotocol/server-google-maps",
     "version": "latest"
   },
-
   "metadata": {
     "homepage": "https://developers.google.com/maps",
     "author": "Anthropic / MCP Community",
-    "tags": ["maps", "geocoding", "places", "directions", "navigation"],
-    "category": "other",
+    "tags": [
+      "maps",
+      "geocoding",
+      "places",
+      "directions",
+      "navigation"
+    ],
+    "category": "data",
     "pricing": "byok",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "search-engine",
+    "origin": "official",
+    "countries": [
+      "global"
+    ],
+    "audience": "general",
+    "selfHosted": false,
+    "sideEffects": "read-only",
+    "authSummary": "api-key"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/hetzner/recipe.json

@@ -4,42 +4,56 @@
   "name": "Hetzner Cloud",
   "description": "Manage Hetzner Cloud infrastructure — servers, networks, load balancers, volumes, firewalls, and more via the Hetzner Cloud API",
   "repository": "https://github.com/dkruyt/mcp-hetzner",
-
   "transports": [
     {
       "type": "stdio",
       "command": "node",
-      "args": ["dist/index.js"],
+      "args": [
+        "dist/index.js"
+      ],
       "env": {
         "HCLOUD_TOKEN": "${HETZNER_API_TOKEN}"
       }
     }
   ],
-
   "auth": {
     "required": true,
     "type": "api-key",
-    "envVars": ["HETZNER_API_TOKEN"],
+    "envVars": [
+      "HETZNER_API_TOKEN"
+    ],
     "credentialsUrl": "https://console.hetzner.cloud/",
     "instructions": "Create an API token in the Hetzner Cloud Console under your project > Security > API Tokens."
   },
-
   "install": {
     "method": "git",
     "repository": "https://github.com/dkruyt/mcp-hetzner",
     "buildCommand": "npm install && npm run build",
     "version": "latest"
   },
-
   "metadata": {
     "homepage": "https://www.hetzner.com/cloud",
     "author": "dkruyt",
-    "tags": ["cloud", "infrastructure", "servers", "vps", "hetzner"],
+    "tags": [
+      "cloud",
+      "infrastructure",
+      "servers",
+      "vps",
+      "hetzner"
+    ],
     "category": "infrastructure",
     "pricing": "byok",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "cloud",
+    "origin": "community",
+    "countries": [
+      "EU"
+    ],
+    "audience": "developer",
+    "selfHosted": false,
+    "sideEffects": "billing-impact",
+    "authSummary": "api-key"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/hostinger/recipe.json

@@ -3,41 +3,56 @@
   "id": "hostinger",
   "name": "Hostinger",
   "description": "Web hosting management via Hostinger API — manage domains, hosting plans, email accounts, and website settings",
-
   "transports": [
     {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@anthropic-pb/hostinger-mcp-server"],
+      "args": [
+        "-y",
+        "@anthropic-pb/hostinger-mcp-server"
+      ],
       "env": {
         "HOSTINGER_API_TOKEN": "${HOSTINGER_API_TOKEN}"
       }
     }
   ],
-
   "auth": {
     "required": true,
     "type": "api-key",
-    "envVars": ["HOSTINGER_API_TOKEN"],
+    "envVars": [
+      "HOSTINGER_API_TOKEN"
+    ],
     "credentialsUrl": "https://hpanel.hostinger.com/api",
     "instructions": "Generate an API token in the Hostinger hPanel under API section."
   },
-
   "install": {
     "method": "npx",
     "package": "@anthropic-pb/hostinger-mcp-server",
     "version": "latest"
   },
-
   "metadata": {
     "homepage": "https://www.hostinger.com/",
     "author": "Anthropic / Hostinger",
-    "tags": ["hosting", "domains", "web-hosting", "email", "dns"],
+    "tags": [
+      "hosting",
+      "domains",
+      "web-hosting",
+      "email",
+      "dns"
+    ],
     "category": "infrastructure",
     "pricing": "byok",
-    "maturity": "stable"
+    "maturity": "stable",
+    "subcategory": "cloud",
+    "origin": "community",
+    "countries": [
+      "global"
+    ],
+    "audience": "developer",
+    "selfHosted": false,
+    "sideEffects": "billing-impact",
+    "authSummary": "api-key"
   },
-
   "capabilities": {
     "tools": true,
     "resources": false,

package/servers/imap-email/README.md

@@ -0,0 +1,37 @@
+# IMAP Email MCP Server
+
+IMAP/SMTP email tools for any provider (list, read, search, move, flag, delete, send, reply, attachments).
+
+## Requirements
+- Node.js + npx
+- IMAP credentials
+- SMTP credentials (optional, for sending)
+
+## Quick Install
+
+### Linux / macOS
+```bash
+mcp-bridge install imap-email
+```
+
+### Windows (PowerShell)
+```powershell
+mcp-bridge install imap-email
+```
+
+## Required Environment Variables
+- `IMAP_HOST`
+- `IMAP_PORT`
+- `IMAP_USER`
+- `IMAP_PASS`
+- `SMTP_HOST`
+- `SMTP_PORT`
+- `SMTP_SEND_ENABLED`
+
+Set `SMTP_SEND_ENABLED=true` to enable sending/replying via SMTP.
+
+## Remove
+
+```bash
+./install-server.sh imap-email --remove
+```

package/servers/imap-email/recipe.json

@@ -6,19 +6,36 @@
   "recipeVersion": "1.0.0",
   "metadata": {
     "category": "communication",
-    "tags": ["email", "imap", "smtp", "inbox"],
+    "tags": [
+      "email",
+      "imap",
+      "smtp",
+      "inbox"
+    ],
     "country": "global",
     "language": "en",
     "homepage": "https://github.com/AIWerk/mcp-server-imap",
     "license": "MIT",
     "pricing": "free",
-    "maturity": "beta"
+    "maturity": "beta",
+    "subcategory": "email",
+    "origin": "aiwerk",
+    "countries": [
+      "global"
+    ],
+    "audience": "general",
+    "selfHosted": true,
+    "sideEffects": "read-write",
+    "authSummary": "api-key"
   },
   "transports": [
     {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@aiwerk/mcp-server-imap"],
+      "args": [
+        "-y",
+        "@aiwerk/mcp-server-imap"
+      ],
       "env": {
         "IMAP_HOST": "${IMAP_HOST}",
         "IMAP_PORT": "${IMAP_PORT}",
@@ -33,13 +50,37 @@
   "auth": {
     "required": true,
     "type": "api-key",
-    "envVars": ["IMAP_HOST", "IMAP_USER", "IMAP_PASS"],
-    "instructions": "Set your IMAP server hostname, username (email), and password. For Gmail use an App Password. Set SMTP_SEND_ENABLED=true to enable email sending.",
+    "envVars": [
+      "IMAP_HOST",
+      "IMAP_PORT",
+      "IMAP_USER",
+      "IMAP_PASS",
+      "SMTP_HOST",
+      "SMTP_PORT",
+      "SMTP_SEND_ENABLED"
+    ],
+    "instructions": "Set your IMAP server hostname, port, username (email), and password. For Gmail use an App Password. Set SMTP_SEND_ENABLED=true to enable email sending.",
     "bootstrap": "env-only"
   },
+  "install": {
+    "method": "npx",
+    "package": "@aiwerk/mcp-server-imap",
+    "version": "latest"
+  },
   "capabilities": {
     "toolCount": 10,
-    "toolNames": ["email_list", "email_read", "email_search", "email_folders", "email_move", "email_flag", "email_delete", "email_send", "email_reply", "email_attachment"],
+    "toolNames": [
+      "email_list",
+      "email_read",
+      "email_search",
+      "email_folders",
+      "email_move",
+      "email_flag",
+      "email_delete",
+      "email_send",
+      "email_reply",
+      "email_attachment"
+    ],
     "sideEffects": "external-write"
   }
 }