feat: initial version

Author: OrKoN

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Chrome version:**
+**Coding agent version:**
+**Model version:**
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Chat log**
+The full log of the chat with your coding agent.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: feature request
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/check-format.yml

@@ -0,0 +1,29 @@
+name: Check Code Format
+
+permissions: read-all
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  check-format:
+    runs-on: ubuntu-latest # You can also use 'macos-latest' or 'windows-latest'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4 # Use the latest stable version
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4 # Use the latest stable version
+        with:
+          node-version: '22' # Specify the Node.js version your project uses (e.g., '18', '20', '22')
+          cache: 'npm' # Caches npm dependencies to speed up builds
+
+      - name: Install dependencies
+        run: npm ci # Use 'npm ci' for clean installs in CI environments, or 'npm install' if you prefer
+
+      - name: Run format check
+        run: npm run check-format

.github/workflows/run-tests.yml

@@ -0,0 +1,33 @@
+name: Compile and run unit tests
+
+permissions: read-all
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+        # Ensure the project compiles properly.
+      - name: Build the project
+        run: npm run build
+
+      - name: Run tests
+        run: npm run test

.gitignore

@@ -0,0 +1,148 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# Stores VSCode specific settings
+.vscode
+!.vscode/*.template.json
+!.vscode/extensions.json
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Build output directory
+build/
+
+log.txt
+
+.DS_Store

.prettierrc.cjs

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @type {import('prettier').Config}
+ */
+module.exports = {
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  ...require('gts/.prettierrc.json'),
+  singleAttributePerLine: true,
+  htmlWhitespaceSensitivity: 'strict',
+};

CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# How to contribute
+
+We'd love to accept your patches and contributions to this project.
+
+## Before you begin
+
+### Sign our Contributor License Agreement
+
+Contributions to this project must be accompanied by a
+[Contributor License Agreement](https://cla.developers.google.com/about) (CLA).
+You (or your employer) retain the copyright to your contribution; this simply
+gives us permission to use and redistribute your contributions as part of the
+project.
+
+If you or your current employer have already signed the Google CLA (even if it
+was for a different project), you probably don't need to do it again.
+
+Visit <https://cla.developers.google.com/> to see your current agreements or to
+sign a new one.
+
+### Review our community guidelines
+
+This project follows
+[Google's Open Source Community Guidelines](https://opensource.google/conduct/).
+
+## Contribution process
+
+### Code reviews
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult
+[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
+information on using pull requests.
+
+## Installation
+
+```sh
+git clone https://github.com/ChromeDevTools/chrome-devtools-mcp.git
+cd chrome-devtools-mcp
+npm ci
+npm run build
+```
+
+### Testing with @modelcontextprotocol/inspector
+
+```sh
+npx @modelcontextprotocol/inspector node build/src/index.js
+```
+
+### Testing with an MCP client
+
+Add the MCP server to your client's config.
+
+```
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "node",
+      "args": ["/path-to/build/src/index.js"],
+    }
+  }
+}
+```
+
+#### Using with VS Code SSH
+
+When running the `@modelcontextprotocol/inspector` it spawns 2 services - one on port `6274` and one on `6277`.
+Usually VS Code automatically detects and forwards `6274` but fails to detect `6277` so you need to manually forward it.
+
+### Debugging
+
+To write debug logs to `log.txt` in the working directory, run with the following commands:
+
+```sh
+npx @modelcontextprotocol/inspector node build/src/index.js --log-file=/your/desired/path/log.txt
+```
+
+You can use the `DEBUG` environment variable as usual to control categories that are logged.