web-basics-mcp

小型で信頼性の高い、エージェント向けWebツールです。APIキーは不要で、バンドルされたインフラストラクチャもありません。

Tools

fetch_urlは、HTMLページやRedditの投稿に対してはクリーンなMarkdownを、PDFに対しては選択可能なテキストを、テキスト/Markdown/JSON/XML応答に対しては直接コンテンツを、PNG、JPEG、WebP、GIF画像に対してはネイティブのMCP画像コンテンツを返します。

長いテキストは制限されたチャンクで読み取られます。返されたnext_start_indexを使用して同じURLを再度呼び出してください：

{
  "url": "https://example.com/long-page",
  "start_index": 8000,
  "max_length": 8000
}

成功した取得結果は5分間メモリにキャッシュされるため、オフセット読み取りは通常同じ抽出されたドキュメントを使用します。検索結果は2分間キャッシュされ、エージェント実行中に同一のSearXNG処理を繰り返すのを防ぎます。両方のキャッシュは制限されており、同時重複リクエストを統合し、いつでも破棄される可能性があります。ツールの正確性はこれらに依存しません。

Related MCP server: Basic MCP Tools

Requirements

• Node.js 20.18.1 またはそれ以降

• JSON応答が有効な既存のSearXNGインスタンス

そのベースURLを環境変数またはこのパッケージの.envファイルに設定してください：

SEARXNG_URL=http://127.0.0.1:8088

SearXNGが利用できない場合でもサーバーは起動するため、fetch_urlは使用可能なままです。web_searchの呼び出しは、SearXNGに到達可能になるまで明確な接続エラーを返します。

Install

git clone https://github.com/yoloyash/web-basics-mcp.git
cd web-basics-mcp
npm install
npm run build

MCPクライアントを設定して、build/index.jsをstdio経由で実行します。例：

codex mcp add web-basics -- node /absolute/path/to/web-basics-mcp/build/index.js

Tool Inputs

web_search

{
  "query": "Model Context Protocol",
  "limit": 5
}

limitのデフォルトは5で、1から10までの値を受け入れます。結果は安定した形状{link, title, snippet}を使用します。

fetch_url

{
  "url": "https://example.com",
  "start_index": 0,
  "max_length": 8000
}

• start_indexのデフォルトは0です。

• max_lengthのデフォルトは8000で、最大20000に制限されています。

• テキスト応答は、total_chars、returned_chars、truncated、および、さらにコンテンツが残っている場合はnext_start_indexを報告します。

• HTMLは最初にDefuddleを使用し、制限付きのフォールバックとしてMozilla Readabilityを使用します。応答は、選択されたextractorと、該当する場合はフォールバック理由を報告します。

• Defuddleのオプションのネットワークバックアップ抽出機能は無効になっています。すべてのリモートリクエストはこのサーバーの検証済みHTTPパス内に留まります。

• Redditの投稿URLはRedditのRSSフィードを介して取得され、そのフィードで利用可能な投稿とコメントが含まれます。RSSにはウェブサイトよりも少ないコメントが含まれる場合があります。

Safety And Limits

• 公開されたHTTP(S) URLのみ受け入れられます。

• URLの認証情報、プライベートホスト名、プライベートDNS結果、および安全でないリダイレクトは拒否されます。

• 各リダイレクトは独立して検証されます。

• リクエストはタイムアウト、制限付きリトライ、応答サイズ制限、および安定したユーザーエージェントを使用します。

• 標準応答と画像は5 MiBに制限されています。PDFは15 MiBに制限されています。

• 取得キャッシュはCache-Control: no-store、no-cache、max-age=0を尊重します。

このサーバーは意図的に、ブラウザ自動化、JavaScriptレンダリング、クローリング、認証、クッキー、プロキシ/VPNルーティング、または回答合成を提供しません。

Development

npm test
npm pack --dry-run

テストは、公開サービスに繰り返しクエリを実行する代わりに、保存されたフィクスチャとローカルスタブを使用します。