@aiwerk/mcp-bridge 1.0.0

package/servers/notion/README.md

@@ -0,0 +1,42 @@
+# Notion MCP Server
+
+Official Notion integration for reading and managing your Notion workspace — pages, databases, blocks, and search.
+
+## Requirements
+- Node.js + npx
+- Notion API token ([My Integrations](https://www.notion.so/my-integrations))
+
+> **Important:** After creating the integration, share the pages/databases you want accessible with it (page → ··· → Connections → Add your integration).
+
+## Quick Install
+
+### Linux / macOS
+```bash
+cd ~/.openclaw/extensions/mcp-client/servers/notion
+chmod +x install.sh && ./install.sh
+```
+
+### Windows (PowerShell)
+```powershell
+cd $env:USERPROFILE\.openclaw\extensions\mcp-client\servers\notion
+.\install.ps1
+```
+
+### Manual Setup
+1. Get your token: https://www.notion.so/my-integrations
+2. Add to .env: `NOTION_API_KEY=ntn_xxxxx`
+3. Add config to openclaw.json (see config.json)
+4. Restart gateway
+
+## What you get
+- 22 tools: search, pages, databases, blocks, users, comments
+- Full Notion API coverage
+- Official package: [@notionhq/notion-mcp-server](https://www.npmjs.com/package/@notionhq/notion-mcp-server)
+
+## Remove
+
+```bash
+./install-server.sh notion --remove
+```
+
+Removes the server from config and cleans up the API token. The server recipe stays in `servers/notion/` for easy reinstall.

package/servers/notion/config.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "name": "notion",
+  "description": "notes & databases",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "@notionhq/notion-mcp-server"
+  ],
+  "env": {
+    "NOTION_TOKEN": "${NOTION_API_KEY}"
+  },
+  "authRequired": true,
+  "credentialsUrl": "https://www.notion.so/my-integrations",
+  "homepage": "https://www.notion.so/"
+}

package/servers/notion/env_vars

@@ -0,0 +1 @@
+NOTION_API_KEY

package/servers/notion/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/notion/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/servers/stripe/README.md

@@ -0,0 +1,40 @@
+# Stripe MCP Server
+
+Stripe MCP server for billing and payments operations.
+
+## Requirements
+- Node.js + npx
+- Stripe API key
+
+## Quick Install
+
+### Linux / macOS
+```bash
+cd ~/.openclaw/extensions/mcp-client/servers/stripe
+chmod +x install.sh && ./install.sh
+```
+
+### Windows (PowerShell)
+```powershell
+cd $env:USERPROFILE\.openclaw\extensions\mcp-client\servers\stripe
+.\install.ps1
+```
+
+### Manual Setup
+1. Get your token: https://dashboard.stripe.com/apikeys
+2. Add to .env: `STRIPE_API_KEY=your_token`
+3. Add config to openclaw.json (see config.json)
+4. Restart gateway
+
+## What you get
+- Customer and subscription tools
+- Invoices and payment intent tools
+- Refund, dispute, and balance tools
+
+## Remove
+
+```bash
+./install-server.sh stripe --remove
+```
+
+Removes the server from config and cleans up the API token. The server recipe stays in `servers/stripe/` for easy reinstall.

package/servers/stripe/config.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "name": "stripe",
+  "description": "payments & billing",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "@anthropic-pb/stripe-mcp-server",
+    "--tools=all",
+    "--api-key=${STRIPE_API_KEY}"
+  ],
+  "env": {
+    "STRIPE_API_KEY": "${STRIPE_API_KEY}"
+  },
+  "authRequired": true,
+  "credentialsUrl": "https://dashboard.stripe.com/apikeys",
+  "homepage": "https://stripe.com/"
+}

package/servers/stripe/env_vars

@@ -0,0 +1 @@
+STRIPE_API_KEY

package/servers/stripe/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/stripe/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/servers/tavily/README.md

@@ -0,0 +1,40 @@
+# Tavily MCP Server
+
+Tavily MCP search and extraction tools.
+
+## Requirements
+- Node.js + npx
+- Tavily API key
+
+## Quick Install
+
+### Linux / macOS
+```bash
+cd ~/.openclaw/extensions/mcp-client/servers/tavily
+chmod +x install.sh && ./install.sh
+```
+
+### Windows (PowerShell)
+```powershell
+cd $env:USERPROFILE\.openclaw\extensions\mcp-client\servers\tavily
+.\install.ps1
+```
+
+### Manual Setup
+1. Get your token: https://app.tavily.com/home
+2. Add to .env: `TAVILY_API_KEY=your_token`
+3. Add config to openclaw.json (see config.json)
+4. Restart gateway
+
+## What you get
+- Web search tools
+- URL extraction and crawling tools
+- Research and mapping helpers
+
+## Remove
+
+```bash
+./install-server.sh tavily --remove
+```
+
+Removes the server from config and cleans up the API token. The server recipe stays in `servers/tavily/` for easy reinstall.

package/servers/tavily/config.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "name": "tavily",
+  "description": "AI-optimized web search",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "tavily-mcp@0.3.0"
+  ],
+  "env": {
+    "TAVILY_API_KEY": "${TAVILY_API_KEY}"
+  },
+  "authRequired": true,
+  "credentialsUrl": "https://app.tavily.com/home",
+  "homepage": "https://tavily.com/"
+}

package/servers/tavily/env_vars

@@ -0,0 +1 @@
+TAVILY_API_KEY

package/servers/tavily/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/tavily/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/servers/todoist/README.md

@@ -0,0 +1,40 @@
+# Todoist MCP Server
+
+Todoist MCP server for tasks, projects, and productivity workflows.
+
+## Requirements
+- Node.js + npx
+- Todoist API token
+
+## Quick Install
+
+### Linux / macOS
+```bash
+cd ~/.openclaw/extensions/mcp-client/servers/todoist
+chmod +x install.sh && ./install.sh
+```
+
+### Windows (PowerShell)
+```powershell
+cd $env:USERPROFILE\.openclaw\extensions\mcp-client\servers\todoist
+.\install.ps1
+```
+
+### Manual Setup
+1. Get your token: https://app.todoist.com/app/settings/integrations/developer
+2. Add to .env: `TODOIST_API_TOKEN=your_token`
+3. Add config to openclaw.json (see config.json)
+4. Restart gateway
+
+## What you get
+- Task and project CRUD tools
+- Sections, labels, and comments tools
+- Scheduling and tracking helpers
+
+## Remove
+
+```bash
+./install-server.sh todoist --remove
+```
+
+Removes the server from config and cleans up the API token. The server recipe stays in `servers/todoist/` for easy reinstall.

package/servers/todoist/config.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "name": "todoist",
+  "description": "task management",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "@doist/todoist-ai"
+  ],
+  "env": {
+    "TODOIST_API_KEY": "${TODOIST_API_TOKEN}"
+  },
+  "authRequired": true,
+  "credentialsUrl": "https://app.todoist.com/app/settings/integrations/developer",
+  "homepage": "https://todoist.com/"
+}

package/servers/todoist/env_vars

@@ -0,0 +1 @@
+TODOIST_API_TOKEN

package/servers/todoist/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/todoist/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/servers/wise/README.md

@@ -0,0 +1,41 @@
+# Wise MCP Server
+
+Wise MCP server for multi-currency account and transfer workflows.
+
+## Requirements
+- Git
+- Node.js + npm
+- Wise API token
+
+## Quick Install
+
+### Linux / macOS
+```bash
+cd ~/.openclaw/extensions/mcp-client/servers/wise
+chmod +x install.sh && ./install.sh
+```
+
+### Windows (PowerShell)
+```powershell
+cd $env:USERPROFILE\.openclaw\extensions\mcp-client\servers\wise
+.\install.ps1
+```
+
+### Manual Setup
+1. Get your token: https://wise.com/settings/api-tokens
+2. Add to .env: `WISE_API_TOKEN=your_token`
+3. Add config to openclaw.json (see config.json)
+4. Restart gateway
+
+## What you get
+- Profile and balance lookup tools
+- Quote and transfer workflow tools
+- Recipient and transaction tools
+
+## Remove
+
+```bash
+./install-server.sh wise --remove
+```
+
+Removes the server from config and cleans up the API token. The server recipe stays in `servers/wise/` for easy reinstall.

package/servers/wise/config.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "name": "wise",
+  "description": "international payments",
+  "transport": "stdio",
+  "command": "node",
+  "args": [
+    "path/to/wise-mcp/dist/cli.js"
+  ],
+  "env": {
+    "WISE_API_TOKEN": "${WISE_API_TOKEN}"
+  },
+  "authRequired": true,
+  "credentialsUrl": "https://wise.com/settings/api-tokens",
+  "homepage": "https://wise.com/"
+}

package/servers/wise/env_vars

@@ -0,0 +1 @@
+WISE_API_TOKEN

package/servers/wise/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/wise/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/src/config.ts

@@ -0,0 +1,168 @@
+import { readFileSync, existsSync, mkdirSync, writeFileSync, chmodSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { BridgeConfig, Logger } from "./types.js";
+import { resolveEnvVars } from "./transport-base.js";
+import { randomBytes } from "crypto";
+
+const DEFAULT_CONFIG_DIR = join(homedir(), ".mcp-bridge");
+const DEFAULT_CONFIG_FILE = "config.json";
+const DEFAULT_ENV_FILE = ".env";
+
+/** Parse a simple KEY=VALUE .env file (no npm dependency). */
+export function parseEnvFile(content: string): Record<string, string> {
+  const env: Record<string, string> = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.substring(0, eqIdx).trim();
+    let value = trimmed.substring(eqIdx + 1).trim();
+    // Strip surrounding quotes
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+    if (key) env[key] = value;
+  }
+  return env;
+}
+
+/** Recursively resolve ${VAR} placeholders in a JSON-compatible value. */
+function resolveConfigValue(value: unknown, extraEnv: Record<string, string | undefined>): unknown {
+  if (typeof value === "string") {
+    return resolveEnvVars(value, "config value", extraEnv);
+  }
+  if (Array.isArray(value)) {
+    return value.map(item => resolveConfigValue(item, extraEnv));
+  }
+  if (value !== null && typeof value === "object") {
+    const resolved: Record<string, unknown> = {};
+    for (const [k, v] of Object.entries(value)) {
+      resolved[k] = resolveConfigValue(v, extraEnv);
+    }
+    return resolved;
+  }
+  return value;
+}
+
+export interface LoadConfigOptions {
+  configPath?: string;
+  logger?: Logger;
+}
+
+/**
+ * Load and validate bridge config.
+ * 1. Read ~/.mcp-bridge/config.json (or custom path)
+ * 2. Parse ~/.mcp-bridge/.env
+ * 3. Resolve ${ENV_VAR} in config values
+ * 4. Validate required fields
+ */
+export function loadConfig(options: LoadConfigOptions = {}): BridgeConfig {
+  const configDir = options.configPath
+    ? join(options.configPath, "..")  // If a file path is given, derive directory
+    : DEFAULT_CONFIG_DIR;
+
+  const configPath = options.configPath || join(DEFAULT_CONFIG_DIR, DEFAULT_CONFIG_FILE);
+  const envPath = join(
+    options.configPath ? join(options.configPath, "..") : DEFAULT_CONFIG_DIR,
+    DEFAULT_ENV_FILE
+  );
+
+  if (!existsSync(configPath)) {
+    throw new Error(
+      `Config file not found: ${configPath}\nRun 'mcp-bridge init' to set up.`
+    );
+  }
+
+  // Load .env file
+  let dotEnv: Record<string, string> = {};
+  if (existsSync(envPath)) {
+    try {
+      dotEnv = parseEnvFile(readFileSync(envPath, "utf-8"));
+    } catch (err) {
+      options.logger?.warn(`[mcp-bridge] Failed to parse .env file: ${err instanceof Error ? err.message : err}`);
+    }
+  }
+
+  // Merge .env into process.env (don't overwrite existing)
+  for (const [key, value] of Object.entries(dotEnv)) {
+    if (process.env[key] === undefined) {
+      process.env[key] = value;
+    }
+  }
+
+  // Read and parse config
+  const rawConfig = JSON.parse(readFileSync(configPath, "utf-8"));
+
+  // Resolve ${VAR} placeholders using .env + process.env
+  const mergedEnv: Record<string, string | undefined> = { ...dotEnv };
+  for (const [k, v] of Object.entries(process.env)) {
+    if (mergedEnv[k] === undefined) mergedEnv[k] = v;
+  }
+
+  let config: BridgeConfig;
+  try {
+    config = resolveConfigValue(rawConfig, mergedEnv) as BridgeConfig;
+  } catch (err) {
+    throw new Error(`Config resolution failed: ${err instanceof Error ? err.message : err}`);
+  }
+
+  // Validate required fields
+  if (!config.servers || typeof config.servers !== "object") {
+    throw new Error("Config must have a 'servers' object");
+  }
+
+  return config;
+}
+
+/** Get the default config directory path. */
+export function getConfigDir(configPath?: string): string {
+  return configPath ? join(configPath, "..") : DEFAULT_CONFIG_DIR;
+}
+
+/** Initialize the config directory with template files. */
+export function initConfigDir(logger: Logger): void {
+  const dir = DEFAULT_CONFIG_DIR;
+
+  mkdirSync(dir, { recursive: true });
+
+  // Set directory permissions (Linux/macOS)
+  try {
+    chmodSync(dir, 0o700);
+  } catch { /* Windows doesn't support chmod */ }
+
+  const configPath = join(dir, DEFAULT_CONFIG_FILE);
+  if (!existsSync(configPath)) {
+    const template: BridgeConfig = {
+      mode: "router",
+      servers: {},
+      toolPrefix: true,
+      connectionTimeoutMs: 5000,
+      requestTimeoutMs: 60000,
+      routerIdleTimeoutMs: 600000,
+      routerMaxConcurrent: 5,
+      http: {
+        auth: {
+          type: "bearer",
+          token: "${MCP_BRIDGE_TOKEN}"
+        }
+      }
+    };
+    writeFileSync(configPath, JSON.stringify(template, null, 2) + "\n");
+    logger.info(`Created config: ${configPath}`);
+  }
+
+  const envPath = join(dir, DEFAULT_ENV_FILE);
+  if (!existsSync(envPath)) {
+    const token = randomBytes(32).toString("hex");
+    writeFileSync(envPath, `# MCP Bridge environment variables\nMCP_BRIDGE_TOKEN=${token}\n`);
+    try {
+      chmodSync(envPath, 0o600);
+    } catch { /* Windows */ }
+    logger.info(`Created .env: ${envPath} (with generated token)`);
+  }
+
+  logger.info(`Config directory ready: ${dir}`);
+}

package/src/index.ts

@@ -0,0 +1,44 @@
+// Core exports for @aiwerk/mcp-bridge
+
+// Transport classes
+export { BaseTransport, resolveEnvVars, resolveEnvRecord, resolveArgs, warnIfNonTlsRemoteUrl } from "./transport-base.js";
+export { StdioTransport } from "./transport-stdio.js";
+export { SseTransport } from "./transport-sse.js";
+export { StreamableHttpTransport } from "./transport-streamable-http.js";
+
+// Router
+export { McpRouter } from "./mcp-router.js";
+export type { RouterToolHint, RouterServerStatus, RouterDispatchResponse, RouterTransportRefs } from "./mcp-router.js";
+
+// Schema conversion
+export { convertJsonSchemaToTypeBox, createToolParameters, setTypeBoxLoader, setSchemaLogger } from "./schema-convert.js";
+
+// Protocol helpers
+export { initializeProtocol, fetchToolsList, PACKAGE_VERSION } from "./protocol.js";
+
+// Config
+export { loadConfig, parseEnvFile, initConfigDir, getConfigDir } from "./config.js";
+
+// Types
+export type {
+  Logger,
+  McpServerConfig,
+  McpClientConfig,
+  McpTool,
+  McpRequest,
+  McpResponse,
+  McpTransport,
+  McpServerConnection,
+  BridgeConfig,
+} from "./types.js";
+export { nextRequestId } from "./types.js";
+
+// Tool naming
+export { pickRegisteredToolName } from "./tool-naming.js";
+
+// Standalone server
+export { StandaloneServer } from "./standalone-server.js";
+
+// Update checker
+export { checkForUpdate, getUpdateNotice, runUpdate, resetNoticeFlag } from "./update-checker.js";
+export type { UpdateInfo } from "./update-checker.js";