usebruno/bruno-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

16 stars 6 forks Качество 74 Тренд 31NOASSERTION

Bruno MCP - это MCP-сервер, который позволяет помощникам AI (Claude, Cursor и любому другому MCP-совместимому клиенту) работать с вашими коллекциями API Bruno.

Обзор

Bruno MCP - это MCP-сервер, который позволяет помощникам AI (Claude, Cursor и любому другому MCP-совместимому клиенту) работать с вашими коллекциями API Bruno. Он раскрывает ваши запросы, папки и среды в качестве инструментов MCP, чтобы агент мог обнаруживать, проверять и запускать их, в то время как ваши коллекции остаются в вашей файловой системе, где их хранит Бруно. Bruno - это клиент API с открытым исходным кодом. Коллекции живут как простые текстовые файлы в папке, в версии с Git. Bruno MCP привносит ту же философию в рабочие процессы ИИ, ваши данные никогда не покидают вашу машину. Коллекция адресована ей, а не идентификатором: пройдите путь от list collections как collectionPath к другим инструментам. Если вы уже знаете, где живет коллекция, вы можете передать ее напрямую, не перечисляя сначала. Запрос адресуется его родственником Path в рамках коллекции (например, user/get-user.bru).

Обзор (машинный перевод)

Бруно MCP - сервер протокола контекстной модели Бруно

Он раскрывает ваши запросы, папки и среды в качестве инструментов MCP, чтобы агент мог обнаруживать, проверять и запускать их, в то время как ваши коллекции остаются в вашей файловой системе, где их хранит Бруно.

Бруно является открытым исходным кодом, офлайн-первый API-клиент. Коллекции живут как простые текстовые файлы в папке, в версии с Git. Bruno MCP привносит ту же философию в рабочие процессы ИИ, ваши данные никогда не покидают вашу машину.

Инструменты

| Инструмент | Цель [скрыто] [скрыто] [[Т0]] Список зарегистрированных коллекций с их именем, маршрутом и средой. Только для чтения. Перечислите запросы в коллекции, сплющенной по папкам (относительный путь + тип + метод + URL); необязательные фильтры search и method. Умышленно мелкий, поэтому быстро держится на больших коллекциях. Только для чтения. T4 Прочитайте полное определение одного запроса с диска: заголовки, парамы, тело, аут, сценарии, тесты, утверждения, переменные, документы, настройки. Читает только, ничего не посылает. Только для чтения

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Bruno MCP - Model Context Protocol server for Bruno

Bruno MCP is an MCP server that lets AI assistants (Claude, Cursor, and any other MCP-compatible client) work with your Bruno API collections.

It exposes your requests, folders, and environments as MCP tools so an agent can discover, inspect, and run them, while your collections stay on your filesystem, right where Bruno keeps them.

Bruno is an open source, offline-first API client. Collections live as plain text files in a folder, versioned with Git. Bruno MCP brings that same philosophy to AI workflows, your data never leaves your machine.

Tools

Tool	Purpose
`list_collections`	List registered collections with their name, path, and environments. Read-only.
`list_requests`	List the requests in a collection, flattened across folders (relative path + type + method + URL); optional `search` and `method` filters. Deliberately shallow, so it stays fast on large collections. Read-only.
`get_request`	Read one request’s full definition from disk: headers, params, body, auth, scripts, tests, assertions, variables, docs, settings. Reads only, sends nothing. Read-only.
`execute_request`	Execute one request via `bru run`; returns status, request and response headers, the response body in full, assertions, and test results. Takes `collectionPath`, `requestPath`, optional `environment` and `variables` overrides.
`run_collection`	Run a whole collection, or a subset of requests/folders (`requests`), via `bru run`; supports `iterations`, a CSV/JSON `dataFile`, `parallel`, `bail`, and `timeoutSeconds` (default 600). Returns a pass/fail summary and a per-request roll-up (outcome, status, response time, failed assertions/tests); headers and bodies are left out.
`list_environments`	List a collection’s environments with their variable count and whether they contain secrets. Read-only.
`get_environment`	Read one environment’s variables (name, value, enabled, secret). Secret values come back as ``. Read-only.

A collection is addressed by its path, not by an id: pass the path from list_collections as collectionPath to the other tools. If you already know where a collection lives, you can pass it directly without listing first. A request is addressed by its relativePath within the collection (e.g. users/get-user.bru).

What ends up in tool output

execute_request returns what the Bruno CLI reports, carrying only the CLI’s own masking:

Request headers whose name is known to carry credentials (Authorization, Cookie, X-Api-Key, X-Auth-Token, …) are masked; a Bearer/Basic scheme is kept, the value is not.
Values the run knows to be secrets (vars:secret in the selected environment, values from .env) are scrubbed everywhere they appear, including URLs and bodies.

Открыть полный README на GitHub

Установка

npx @modelcontextprotocol/inspector node /abs/path/to/dist/index.js

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "bruno": {
      "command": "node",
      "args": ["/abs/path/to/dist/index.js", "--collection", "/path/to/collection"]
    }
  }
}