local-web-mcp

Version 0.3.0 · AGPL-3.0

このツールは AI の支援を受けて開発されていますが、アップロード前に人間による評価を受けています。

自分のマシン上で動作するフォールバック Web フェッチャーを Claude に提供する MCP サーバーです。組み込みのフェッチャーがブロックされた場合、こちらはあなたの IP、あなたの接続、そしてオプションでログイン済みセッションを使って試行します。

ツールは 1 つだけです: fetch_url_locally。

解決する問題

ホステッドフェッチャーはデータセンターの IP レンジから実行されるため、多くのサイトが真っ向から拒否します。ローカルの stdio MCP サーバーはそうではありません。クライアントがあなたのマシン上でプロセスを起動するため、リクエストはあなたの通常の接続から発信されます。

ホステッドフェッチャーが読めなかったサイト（CNBC、Politiken、Bloomberg を含む）で動作確認済みです。

Related MCP server: auth-fetch-mcp

変わらないもの

枠組みが過大評価を招きがちなので、はっきり述べておく価値があります。

• モデルの推論は依然として Anthropic のサーバー上で実行されます。

• 取得したページのテキストは、依然としてツール出力としてモデルに送信されます。認証済みセッションを通じて読み取られたものはすべてそれに含まれます。

• 変更されるのは Web サイトと通信するのは誰か であり、モデルがどこで実行されるか ではありません。

厳格な境界

そのページは JavaScript を実行せずに読めますか？

読めるなら、このツールで対応できます。読めないなら、ヘッダー、TLS、Cookie のどの層でもそこに到達できず、User-Agent をどんなに調整しても役に立ちません。DataDome、Cloudflare Turnstile、PerimeterX などを使用しているサイトは、通過するために実行しなければならないチャレンジを配信します。そのような場合は、ブラウザベースのツールを使うか、自分でページを開いてください。

これは修正すべきバグではなく、認識すべき境界です。

判定

すべてのレスポンスにはラベルが付きます。危険なケースは明らかな 403 ではなく、ページではない 200 です。ボットの中間ページ、同意ウォール、空のクライアントレンダリングシェルなどです。これらはあたかも記事であるかのように要約されます。

ok 以外の判定はすべて、モデルに対して本文をコンテンツとして扱わないよう明示的な警告を付加します。

本文の証拠はステータスコードよりも優先されます。ペイウォール付き記事を HTTP 403 として配信する出版社は、blocked ではなく login_required として報告されます。そこでの有益なアドバイスはブラウザに頼ることではなく、Cookie をエクスポートすることだからです。

検出は文言ではなくベンダーインフラに基づいて一致します。チャレンジページはローカライズされているため、captcha-delivery.com は「デバイスを確認しています」のような文言が信頼できない場合でも、信頼できるシグナルです。レスポンスヘッダー内のベンダー Cookie は、拒否ステータスと対になっている場合に証拠として扱われます。

ツール

fetch_url_locally(url, max_chars=20000, use_session=true)

応答は、短いヘッダーとそれに続く抽出テキストで構成されます:

URL: https://example.com/article
Status: 200
Verdict: ok
Title: The headline
Session: authenticated (the user's cookies were sent)

The article text...

Session: は、Cookie が実際に読み込まれ、そのホストにスコープされている場合にのみ表示されます。ok 以外の判定は、本文をコンテンツとして扱わないようモデルに指示する WARNING: 行を追加します。

失敗は原因を明示するエラーとして返されます。例: [blocked_host] Host '192.168.1.5' resolves to a private or internal address。コード: invalid_url, blocked_scheme, blocked_host, dns_failure, timeout, too_many_redirects, upstream_error, invalid_argument。

必要条件

• Python 3.11+ (asyncio.timeout を使用)。uv を使えば自分でインストールする必要はありません。uv が適切なインタープリターを取得します

• Claude Desktop または Claude Code。stdio サーバーはブラウザやモバイルアプリでは動作しません。これらは公開リーチ可能な HTTPS エンドポイントを必要とします。

インストール

uv を使うと、適切な Python と依存関係を uv 自身が取得します:

uv --directory /absolute/path/to/local-web-mcp run local-web-mcp

サーバーを登録する前に、ターミナルで一度実行してください。 初回実行は環境の解決と構築を行うため時間がかかり、クライアントがコールド起動すると、設定が正しくても諦めてサーバーが失敗したと報告する可能性があります。

Starting local-web と表示され、その後 stdin でクライアントを待ちます。これが正常に動作するサーバーの姿です。その行が表示されたら環境は構築されています。Ctrl+C を押して先に進んでください。

または、通常の仮想環境を使う場合:

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Claude Desktop への登録

claude_desktop_config.json に追加します (macOS: ~/Library/Application Support/Claude/、Linux: ~/.config/Claude/):

{
  "mcpServers": {
    "local-web": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/local-web-mcp",
        "run",
        "local-web-mcp"
      ]
    }
  }
}

uv がクライアントから見える PATH にない場合は、その絶対パスを command として使用します。仮想環境の場合の相当する設定は次のとおりです:

{
  "mcpServers": {
    "local-web": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/local_web_mcp.py"]
    }
  }
}

Claude Code の場合:

claude mcp add local-web -- uv --directory /absolute/path/to/local-web-mcp run local-web-mcp

設定

すべてオプションです。すべての設定には動作するデフォルトがあります。

デフォルトの Accept-Language は最初にデンマーク語を要求します。これは中立的なデフォルトではなく意図的なものです。英語や他の言語が必要な場合は LOCALWEB_ACCEPT_LANGUAGE を設定してください:

"env": { "LOCALWEB_ACCEPT_LANGUAGE": "en-GB,en;q=0.9" }

セッション Cookie

LOCALWEB_COOKIE_FILE にブラウザ拡張機能からエクスポートしたファイルを指定します。ローダーは、ヘッダー行があってもなくても Netscape cookies.txt を受け付け、一般的な拡張機能からの JSON エクスポートも受け付けます。cookies.txt.example を参照してください。

必ず LOCALWEB_COOKIE_DOMAINS を設定してください。 これがないと jar 全体が有効になり、どのフェッチも無関係なセッションを運ぶ可能性があります。設定すると、jar がクライアントに届く前に、ロード時にそれらのドメイン外のすべての Cookie が破棄されます。マッチングはサブドメインをカバーします (example.com は www.example.com をカバー) が、類似ドメイン (evil-example.com) はカバーしません。

留意すべき点が 3 つあります:

1. セッションを通じて読み取られたコンテンツは、ツール出力としてモデルに送信されます。

2. Cookie ファイルは資格情報ファイルです。chmod 600 にしてください。また、このリポジトリでは gitignore されています。

3. Cookie は期限切れになります。以前は動作していたソースが login_required を返す場合、それはアクセス権の喪失ではなく、通常は古いエクスポートが原因です。

ページが本当に公開されているかどうかを確認するには、use_session=false を渡してください。

ローカルネットワークへのアクセス

プライベートアドレスはデフォルトでブロックされており、これは意図的です。モデルは直前に読んだテキストから URL を選ぶことがあるため、取得したページが 192.168.1.1 へ誘導しようとする可能性があります。ブロックリストにより、ページコンテンツへのプロンプトインジェクションでこれをネットワークスキャナーに変えることはできません。

全面許可スイッチよりも、狭い許可リストを優先してください:

"env": { "LOCALWEB_ALLOWLIST": "nas.local,nas" }

セキュリティ

• スキームは http と https のみに制限。資格情報を含む URL は拒否

• ホスト名を解決し、リクエスト前にすべての返されたアドレスを検証

• チェック前に IPv6 マップされた IPv4 (::ffff:10.0.0.1) をアンラップ

• クラウドメタデータエンドポイントは無条件にブロック。ホスト名は許可リストと ALLOW_PRIVATE の両方より前に解決されるため、どちらもそれらを開くことはできない

• リダイレクトと meta リフレッシュは手動で追跡し、各ホップで再検証

• 記録されるのは Cookie の数のみ。名前、値、ドメインは決して記録されない

既知の制限

• JavaScript なし。 上記の厳格な境界。

• DNS リバインディング。 ホスト名は検証のために解決され、接続時に再度解決されます。このギャップを埋めるには、接続を検証済み IP に固定する必要があります。信頼できないネットワークで ALLOW_PRIVATE を有効にする前に実施する価値があります。

• チャレンジ検出はシグネチャベースであり、ベンダーがマークアップを変更するにつれてずれていきます。判定がおかしいと思ったら inspect_response.py を実行してください。

• HTML からテキストへの抽出は依存関係なしの簡易的なものです。 本格的な記事抽出には trafilatura の方がはるかに優れているでしょう。

ファイル

誤った判定の診断

uv run python inspect_response.py https://example.com/article

ステータス、注目すべきヘッダー、本文の先頭を表示し、その内容に対してサーバー自身の検出を実行します。検出ロジックを変更する前には必ずこれを確認してください。 ブラウザとこのフェッチャーには、しばしばまったく異なるレスポンスが返されます。したがって、画面に表示される内容はフェッチャーが受け取ったものの証拠にはなりません。

テスト

uv run python unit_test.py
uv run python smoke_test.py

unit_test.py はオフラインで動作し、失敗時には非ゼロの終了コードを返すため、pre-commit ゲートとして機能します。smoke_test.py は stdio を介してサーバーを駆動し、ライブリクエストを1回行うため、ネットワーク接続が必要です。両方ともリポジトリのルートから実行してください。

プレーンな venv を使用する場合は、uv run python の代わりに .venv/bin/python を使用してください。

ライセンス

Copyright (C) 2026 David Lindholm.

GNU Affero General Public License v3.0 またはそれ以降。LICENSE を参照してください。

このプログラムは、有用であることを願って配布されていますが、いかなる保証もありません。商品性または特定の目的への適合性についての暗黙の保証も一切ありません。