Contributing to Firefox DevTools MCP

Issues

Issues are tracked on Bugzilla under product: Developer Infrastructure, component: Firefox MCP.

• File a new issue
• Meta bug (tracks all firefox-devtools-mcp issues)

For questions and discussion, join the #firefox-devtools-mcp Matrix room.

Local development

npm install
npm run build

# Run with Inspector against local build
npx @modelcontextprotocol/inspector node dist/index.js --headless --viewport 1280x720

# Or run in dev with hot reload
npm run inspector:dev

Testing

npm run test:run          # all tests once (unit + integration)
npm test                  # watch mode

See docs/testing.md for full details on running specific test suites, the e2e scenario coverage, and known issues.

CI and Release

GitHub Actions for CI, Release, and npm publish are included. See docs/ci-and-release.md for details and required secrets.

Code of Conduct

This project follows the Mozilla Community Participation Guidelines.

License

By contributing, you agree that your contributions will be dual-licensed under MIT and Apache 2.0, matching the project's license.