camofox-mcp

camofox-mcp is a minimal MCP stdio server for camofox-browser. It is packaged as a Node.js CLI so users can run it directly with npx without cloning this repository first.

Requirements

• Node.js 18 or newer
• A running camofox-browser server, defaulting to http://127.0.0.1:9377

Quick Start

After publishing this package to npm, users can run:

npx @louislai/camofox-mcp

They can also inspect the CLI:

npx @louislai/camofox-mcp --help
npx @louislai/camofox-mcp --version

Environment Variables

• CAMOFOX_BASE_URL: Base URL of the camofox-browser API. Default: http://127.0.0.1:9377
• CAMOFOX_USER_ID: Default browser user id. Default: default
• CAMOFOX_SESSION_KEY: Default session key. Default: default
• CAMOFOX_API_KEY: Required for camofox_import_cookies
• CAMOFOX_COOKIES_DIR: Cookie directory. Default: ~/.camofox/cookies

MCP Client Example

Example config for an MCP client that launches the package through npx:

{
  "mcpServers": {
    "camofox": {
      "command": "npx",
      "args": ["-y", "@louislai/camofox-mcp"],
      "env": {
        "CAMOFOX_BASE_URL": "http://127.0.0.1:9377",
        "CAMOFOX_USER_ID": "default",
        "CAMOFOX_SESSION_KEY": "default"
      }
    }
  }
}

Local Development

npm install
npm run help
npm start

Publish

Push a version tag to trigger automatic npm publish via GitHub Actions:

# Update version in package.json, then:
git tag v0.x.0
git push origin v0.x.0