Breakwire MCPサーバー
コミット 2026年11月5日ソースコードと紐付けられたレジストリ内のエラー文字列を検索することで、AIクライアントが破壊的変更、APIの非推奨化、モデルの廃止を特定し、説明できるようにします。
別名 breakwire-org/breakwire
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月5日
- ライセンス
- MIT
Breakwire MCPとは
ソースコードと紐付けられたレジストリ内のエラー文字列を検索することで、AIクライアントが破壊的変更、APIの非推奨化、モデルの廃止を特定し、説明できるようにします。
プロジェクトのREADMEから生成された概要
Breakwire MCP server について
Breakwireは、破壊的変更、APIの非推奨化、およびモデルの廃止を特定するために開発者が利用するツールです。このレジストリを使用すると、AIクライアントはエラー文字列を検索し、ツールやモデルが期待通りに動作しなくなった理由を説明する特定の情報を取得できます。ベンダーが文書化したエラー文字列、影響を受けるバージョン、期限、および推奨される修正方法が提供されます。
ユーザーは、Claude、Cursor、VS Code、Windsurfなどのクライアント向けにMCP serverの設定を通じて統合するか、提供されているTypeScriptおよびPythonのSDKを使用できます。このシステムは、安全かつプライバシーを重視して設計されており、IPv6アドレス、UUID、認証情報などの機密データは、ローカル環境を離れる前にローカルでマスキングされます。APIによるルックアップを介したリモートサービスとして機能しますが、スタックファイルをローカルで解析することで、シークレットが外部に出ないよう保証します。
単純なエラー検索にとどまらず、特定のスタックにおける変更を確認するためのセッションブリーフもサポートしています。また、GitHub Actionを使用してCIパイプラインに統合し、期限が迫っている場合やセキュリティアドバイザリが出ている場合にビルドを失敗させることも可能です。
できること
- 1認識できないエラー文字列の説明エラーメッセージをレジストリに送信することで、文書化された説明と修正方法を受け取ります。
- 2モデルとAPIの変更の監視学習データのカットオフに関連して、最近のモデルのリリース、改訂、または非推奨化を確認します。
- 3CIセーフティチェックの自動化GitHub Actionを使用して、APIの期限やセキュリティアドバイザリが近づいた際にデプロイを防止します。
- 4起動時の環境変更の監査セッションの開始時にセッションブリーフを実行し、現在のスタックに影響を与える変更がないかを確認します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Breakwire MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにBreakwire MCPをインストール
$ claude mcp add breakwire -- npx -y breakwireCursorにBreakwire MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"breakwire": {
"command": "npx",
"args": [
"-y",
"breakwire"
]
}
}
}VS CodeにBreakwire MCPをインストール
.vscode/mcp.json
{
"servers": {
"breakwire": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"breakwire"
]
}
}
}VS Code CLIにBreakwire MCPをインストール
$ code --add-mcp '{"name":"breakwire","type":"stdio","command":"npx","args":["-y","breakwire"]}'Claude DesktopにBreakwire MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"breakwire": {
"command": "npx",
"args": [
"-y",
"breakwire"
]
}
}
}CodexにBreakwire MCPをインストール
$ codex mcp add breakwire -- npx -y breakwireCodex config.tomlにBreakwire MCPをインストール
~/.codex/config.toml
[mcp_servers.breakwire] command = "npx" args = ["-y", "breakwire"]
Gemini CLIにBreakwire MCPをインストール
$ gemini mcp add -s user breakwire npx -- -y breakwireGemini settings.jsonにBreakwire MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"breakwire": {
"command": "npx",
"args": [
"-y",
"breakwire"
]
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能breakwire-org/breakwire is public and reachablegithub.com/breakwire-org/breakwire ↗合格
- パッケージがこのリポジトリをソースとして指定breakwire names breakwire-org/breakwire as sourcenpmjs.com/package/breakwire ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-05github.com/breakwire-org/breakwire ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from breakwire合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るBreakwire clients, MCP config and CI check
Current release: clients 0.12.0 (npm breakwire, PyPI breakwire, PyPI langchain-breakwire) · server 0.12.28 · GitHub Action breakwire-check 1.2.0 · CHANGELOG
Breakwire is a source-linked registry of changes that break AI agents: model retirements, API
deprecations, SDK breaking releases, MCP spec changes and security advisories. Send it an error, get back the claim
that explains it (e.g. AN-2026-0025) with the vendor's documented error string, affected versions, deadline, fix and
primary source.
Try it: one call, no key, no install
curl -X POST https://breakwire.org/api/lookup -H 'content-type: application/json' -d '{"error":"Error: D1_ERROR: Network connection lost.","compact":true}'
Returns explained: true and claim AN-2026-0143 (the vendor-documented D1 error, the fix and its source). Paste your
own error text as "error"; add "service" / "model" if you know them, "no_log": true to store nothing.
This repo holds everything that talks to it:
| Path | Install | |
|---|---|---|
| TypeScript/JS client (zero deps, Node 18+, Workers) + Vercel AI SDK tools | packages/js | npm i breakwire@latest |
| Python client (stdlib only, 3.9+) | packages/python | pip install -U breakwire |
| LangChain tools + callback handler | packages/langchain-breakwire | pip install -U langchain-breakwire |
| MCP server config for Claude, Cursor, VS Code, Cline, Codex, Windsurf, Gemini CLI | mcp/CLIENTS.md | https://breakwire.org/mcp |
| GitHub Action: fail CI on near deadlines / advisories | action (published as breakwire-org/breakwire-check) |
uses: breakwire-org/breakwire-check@v1 |
| Framework snippets: Vercel AI SDK, OpenAI Agents, Anthropic SDK, LangChain, MCP TS client | snippets | |
| Trigger packages: Claude Code plugin (skill + MCP), Cursor rule, AGENTS.md block | triggers | /plugin marketplace add breakwire-org/breakwire |
| Gemini CLI extension (remote MCP + GEMINI.md context) | gemini-extension.json | gemini extensions install https://github.com/breakwire-org/breakwire |
Installed the Claude Code plugin or the Gemini extension earlier? Their manifests stayed at 0.4.0 / 0.8.0, and Claude Code only
refreshes a plugin when that version string changes, so later skill/hook updates (session brief, GET forms, fail-open) never
reached you. Both now track the clients version (0.12.0). Update with claude plugin marketplace update breakwire && claude plugin update breakwire@breakwire
or gemini extensions update breakwire.
30 seconds
curl -s https://breakwire.org/api/lookup -H 'content-type: application/json' \
-d '{"error":"tool_choice: type \"tool\" and \"any\" are not supported for this model.","service":"anthropic-api"}'
import { withBreakwire } from 'breakwire';
const create = withBreakwire((p) => anthropic.messages.create(p), { service: 'anthropic-api' });
try { await create(params) } catch (e) { console.log(e.breakwire?.id, e.breakwire?.fix); throw e }
from breakwire import with_breakwire
with with_breakwire(service="openai-api"):
client.responses.create(...) # exception gets .breakwire (id, fix, url) and a traceback note
When to call it
- Session start:
session_brief(MCP) /sessionBrief()/session_brief()/npx breakwire brief. Silent when nothing changed for your exact stack. - An error you do not recognise. 2. Code that names a model id or SDK version. 3. A deploy or upgrade.
For 1-3, step one:
GET https://breakwire.org/api/changes?from=<your training cutoff>(changes, new model launches, revisions). Fail open: if Breakwire is slow or down, carry on. Details: triggers/TRIGGERS.md.
What's new in 0.12.0 (clients)
Current clients are 0.12.0 (parity with Breakwire 0.12). Upgrade from 0.1–0.7: pip install -U breakwire · npm i breakwire@latest · pip install -U langchain-breakwire. Details: CHANGELOG.md.
- GET forms (0.12.19 / 0.12.23):
GET /api/stack?packages=&node=andGET /api/session-brief?packages=&node=&services=match POST. The Action and SDKs still POST; curl-only / GET-only checkers use GET. Docs: https://breakwire.org/llms.txt. - Trigger packages (Claude Code skill, Cursor rule, AGENTS.md) now document those GET forms and the 0.12.0 upgrade commands.
What's new in 0.7.0 (clients)
- Session brief with a local cursor:
sessionBrief()/session_brief()returncontext: nullwhen clear (inject nothing), else at most 5 source-linked items. Later calls send only a fingerprint and cursor (304 when unchanged). npx breakwire brieffor session-start hooks; the Claude Code plugin runs it on startup.- Stack checks are strict + compact by default. No-log lookups return a
receiptyou can close with an outcome andevidence_type. Details in CHANGELOG.md.
What's new in 0.6.0 (clients)
Security and correctness release; see CHANGELOG.md and SECURITY.md.
- Redirects never carry credentials or bodies to another origin. Clients follow redirects only to
https://breakwire.org, the base URL's origin and anytrustedOrigins/trusted_originsyou pin. - Stack files are parsed in your process.
stack()/subscribe()send only dependency and runtime facts;previewStack()/preview_stack()show the exact body; raw files needrawFiles: true/raw_files=True. - Retry works in the default no-log mode, and the local cache keys on every lookup option.
- Broader local redaction (IPv6, UUIDs, request/trace ids, filesystem and UNC paths, credentials in any URI scheme,
secret-named JSON fields) with
previewRedaction()/preview_redaction(). - Python
with_breakwireaccepts everylookup()option (compact,min_score,max_matches,since,reflex).
Principles
- Opt-in and harmless. Lookups happen only on errors, are time-boxed, and never throw or replace your error.
- Secrets stay home. Keys, tokens, emails, IPv4/IPv6 addresses, UUIDs and request ids, query strings, credentials
in URLs and filesystem paths are stripped in your process before sending (shared test cases;
previewRedaction()/preview_redaction()show exactly what would leave); the server redacts again. Stack files are parsed locally and only dependency facts are sent. Redirects never carry credentials or bodies to another origin. - No silent reporting. Outcome reports ("did the fix work") are sent only with
autoReport/auto_reporton, and only after your retry actually ran. - Honest data.
signaturevsrelatedconfidence, explicit "not covered" for services without claims, and community verification that has just started: most claims have no outcome reports yet, and each claim says so.
Development
cd packages/js && npm ci && npm test # offline unit tests (+ npm run test:live)
cd packages/python && python -m unittest discover -s tests
cd packages/langchain-breakwire && python -m unittest discover -s tests
cd action && npm test
cd snippets && npm ci && npm test # real SDKs against a mock vendor + live Breakwire
node scripts/versions.mjs --check # fails on stale versions (edit versions.json, run without --check)
Versions live in one place, versions.json. node scripts/versions.mjs writes them into the package
manifests, source constants and the README banners; CI (.github/workflows/ci.yml) runs the
check plus every suite. Shared cross-language fixtures: tests/ (redaction, redirect policy, stack parsing,
lookup option contract).
Live tests use log_miss: false and never send outcome reports. Set BREAKWIRE_BASE_URL to point at another deployment.
API: https://breakwire.org/llms.txt · OpenAPI: https://breakwire.org/openapi.json · Data: CC BY 4.0 · Code: MIT
Breakwire MCPのよくある質問
Breakwire MCPをClaude Codeに追加するには
ターミナルでclaude mcp add breakwire -- npx -y breakwireを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Breakwire MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
エラーが送信された際、Breakwireはどのような情報を提供しますか?
ベンダーが文書化しているエラー文字列、影響を受けるバージョン、期限、修正方法、および主要なソースを含む、エラーの説明(claim)を返します。
Breakwireを使用することで、セキュリティが損なわれたり、シークレットが露出したりすることはありませんか?
いいえ。キー、トークン、IPアドレスなどのシークレットは、送信前にローカルプロセスで削除され、サーバー側でもさらに情報のマスキングが行われます。