@avavilov/yandex-browser-control
v0.0.1
Published
Control Yandex browser tabs, windows, and navigation
Readme
Yandex Browser Control
An MCP server for controlling Yandex Browser. You can connect it to Claude Desktop (or any MCP-capable host) to manage tabs, windows, and navigation.
Installation
To use as an npm package:
npm install @avavilov/yandex-browser-controlOr use as a Claude Desktop MCP server:
- If distributed via the Claude Desktop Extensions catalog: open Claude Desktop → Extensions and install "Yandex Browser Control" (when available).
- For local development today: add it as a custom MCP server in Claude Desktop.
- Build or run from source (see Development below).
- In Claude Desktop, go to Settings → Extensions → Model Context Protocol → Add server (Command), and point it to either:
- Dev: run command
npm run devin this repository directory - Prod: run command
node dist/index.jsin this repository directory
- Dev: run command
Usage
Once connected, you can control Yandex Browser directly through Claude Desktop.
Logging
- All logs are emitted to stderr only (never stdout) to comply with MCP over stdio.
- In addition, logs are duplicated to a temp file. The absolute path to this file is printed to stderr on startup, for example:
logging to file: /var/folders/…/yandex-browser-control.log.12345You can control verbosity with the LOG_LEVEL env variable (default: info).
Contributing
See contributing.md for development, build, and code quality instructions.
Project Structure
src/— TypeScript source code for the server.dist/— Compiled JavaScript output (generated on build).src/tools/— MCP tools, one directory per tool with anindex.tsthat exports metadata, input schema (when needed), handler, and types.
Tools
- Each tool lives in
src/tools/<tool-name>/index.tsand should export:nameanddescriptionstringsinputSchema(Zod raw shape) when the tool takes parameters; omitinputSchemaentirely for no-arg toolshandlerfunction returning{ content: [{ type: 'text', text: string }] }or structured content- any
types(e.g.,Input,Output)
- Register all tools in
src/tools/index.tsviaregisterTools(server), which is invoked fromsrc/index.ts.
License
MIT
