Super Fetch MCP Server

🚀 superFetch MCP Server

superFetch MCP Serverは、Model Context Protocol (MCP) サーバーです。ウェブページを取得し、Mozilla Readabilityを使用して読みやすいコンテンツを抽出し、AIに適したJSONLまたはMarkdownを返します。

クイックスタート | ツールの選び方 | 利用可能なツール | リソース | 設定 | セキュリティ | 開発

MCP Registryに公開されています - io.github.j0hanz/superfetch を検索してください。

⚠️ 重要提示

このサーバーは、AIアシスタントの代わりにURLにアクセスできます。組み込みのSSRF保護により、プライベートIP範囲とクラウドメタデータエンドポイントがブロックされますが、機密環境でのデプロイ時には注意してください。

✨ 主な機能

ツールの選び方

このガイドを使用して、ウェブコンテンツ抽出のニーズに合った適切なツールを選択してください。

決定木

AI用のウェブコンテンツが必要ですか？
- 構造化されたJSONLブロックが必要 -> fetch-url (形式: jsonl)
- クリーンなMarkdownが必要 -> fetch-markdown
- Markdownが必要で、contentBlocksの数も必要 -> fetch-url (形式: markdown)

クイックリファレンステーブル

一般的な使用例

🚀 クイックスタート

superFetchをMCPクライアント設定に追加するだけで、インストールは不要です。

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"]
    }
  }
}

VS Code

ワークスペースの .vscode/mcp.json に追加します。

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"]
    }
  }
}

カスタム設定を使用する場合

env プロパティに環境変数を追加して、SuperFetchの動作を設定します。

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"],
      "env": {
        "CACHE_TTL": "7200",
        "LOG_LEVEL": "debug",
        "FETCH_TIMEOUT": "60000"
      }
    }
  }
}

すべての利用可能なオプションについては、設定 を参照してください。

Cursor

1. Cursor設定を開きます。
2. 機能 > MCPサーバー に移動します。
3. "+ 新しいグローバルMCPサーバーを追加" をクリックします。
4. この設定を追加します。

{
  "mcpServers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"]
    }
  }
}

ヒント (Windows): 問題が発生した場合は、cmd /c "npx -y @j0hanz/superfetch@latest --stdio" を試してください。

[mcp_servers.superfetch]
command = "npx"
args = ["-y", "@j0hanz/superfetch@latest", "--stdio"]

[mcp_servers.superfetch]
command = "npx"
args = ["-y", "@j0hanz/superfetch@latest", "--stdio"]
env = { CACHE_TTL = "7200", LOG_LEVEL = "debug", FETCH_TIMEOUT = "60000" }

code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

{
  "mcpServers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"]
    }
  }
}

# 設定ファイルを開く
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# またはVS Codeで開く
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

code %APPDATA%\Claude\claude_desktop_config.json

📦 インストール

グローバルインストール

npm install -g @j0hanz/superfetch

# stdioモードで実行
superfetch --stdio

# HTTPサーバーを実行 (API_KEYが必要)
superfetch

ソースからインストール

git clone https://github.com/j0hanz/super-fetch-mcp-server.git
cd super-fetch-mcp-server
npm install
npm run build

サーバーの実行

node dist/index.js --stdio

API_KEY=supersecret npx -y @j0hanz/superfetch@latest
# サーバーは http://127.0.0.1:3000 で実行されます

$env:API_KEY = "supersecret"
npx -y @j0hanz/superfetch@latest

💻 利用可能なツール

ツールのレスポンスに関する注意事項

両方のツールは次を返します。

• 機械可読フィールドの structuredContent
• 次を含む content ブロック:
  • structuredContent のJSONを含む text ブロック
  • 完全なコンテンツを含む file:///... URIを持つ resource ブロック (stdioに適しています)
  • コンテンツが MAX_INLINE_CONTENT_CHARS を超え、キャッシュが有効な場合の resource_link ブロック

コンテンツが大きすぎてキャッシュが無効な場合、サーバーは出力を切り捨て、...[truncated] を追加します。

fetch-url

ウェブページを取得し、セマンティックコンテンツブロックを持つAIが読めるJSONL形式に変換します。format: "markdown" でMarkdownを要求することもできます。

structuredContent の例:

{
  "url": "https://example.com/article",
  "title": "Example Article",
  "contentBlocks": 42,
  "fetchedAt": "2025-12-11T10:30:00.000Z",
  "format": "jsonl",
  "contentSize": 12345,
  "cached": false,
  "content": "{\"type\":\"metadata\",\"title\":\"Example Article\",\"url\":\"https://example.com/article\"}\n{\"type\":\"heading\",\"level\":1,\"text\":\"Introduction\"}"
}

fetch-markdown

ウェブページを取得し、オプションのフロントマター付きのクリーンなMarkdownに変換します。

structuredContent の例:

{
  "url": "https://example.com/docs",
  "title": "Documentation",
  "fetchedAt": "2025-12-11T10:30:00.000Z",
  "markdown": "---\ntitle: Documentation\nsource: \"https://example.com/docs\"\n---\n\n# Getting Started\n\nWelcome...",
  "contentSize": 9876,
  "cached": false,
  "truncated": false,
  "file": {
    "downloadUrl": "/mcp/downloads/markdown/abc123def456",
    "fileName": "documentation.md",
    "expiresAt": "2025-12-11T11:30:00.000Z"
  }
}

file は、コンテンツがキャッシュされ、インライン表示に大きすぎる場合にのみ、HTTPモードで含まれます。

大きなコンテンツの処理

• インライン制限: MAX_INLINE_CONTENT_CHARS (デフォルト 20000)。
• コンテンツが制限を超え、キャッシュが有効な場合、レスポンスには resourceUri と resource_link ブロックが含まれます。
• キャッシュが無効な場合、コンテンツは ...[truncated] で切り捨てられます。
• リクエストごとに maxContentLength を使用して、より低い制限を適用できます。

リソース

リソースサブスクリプションは、キャッシュエントリが更新されたときにクライアントに通知します。

ダウンロードエンドポイント (HTTPモード)

HTTPモードで実行すると、キャッシュされたコンテンツを直接ダウンロードできます。

エンドポイント

GET /mcp/downloads/:namespace/:hash

• namespace: markdown または url
• 認証が必要 (Authorization: Bearer <API_KEY> または X-API-Key: <API_KEY>)

レスポンスヘッダー

使用例

curl -H "Authorization: Bearer $API_KEY" \
  http://localhost:3000/mcp/downloads/markdown/abc123.def456 \
  -o article.md

エラーレスポンス

設定

MCPクライアント設定の env プロパティに環境変数を追加して、SuperFetchの動作を設定します。

フェッチャー設定

キャッシュ設定

出力設定

ロギング設定

抽出設定

HTTPサーバー設定

CORS設定

レート制限

設定プリセット

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"]
    }
  }
}

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"],
      "env": {
        "LOG_LEVEL": "debug",
        "CACHE_ENABLED": "false"
      }
    }
  }
}

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"],
      "env": {
        "CACHE_TTL": "7200",
        "CACHE_MAX_KEYS": "500",
        "LOG_LEVEL": "warn"
      }
    }
  }
}

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"],
      "env": {
        "USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
      }
    }
  }
}

{
  "servers": {
    "superFetch": {
      "command": "npx",
      "args": ["-y", "@j0hanz/superfetch@latest", "--stdio"],
      "env": {
        "FETCH_TIMEOUT": "60000",
        "CACHE_ENABLED": "false",
        "LOG_LEVEL": "warn"
      }
    }
  }
}

HTTPモードの詳細

HTTPモードは、MCP Streamable HTTPトランスポートを使用します。ワークフローは次のとおりです。

1. POST /mcp を initialize リクエストで、なし mcp-session-id ヘッダーで送信します。
2. サーバーはレスポンスヘッダーに mcp-session-id を返します。
3. そのヘッダーを後続の POST /mcp、GET /mcp、および DELETE /mcp リクエストに使用します。

MAX_SESSIONS に達すると、サーバーは可能な場合は最も古いセッションを削除し、そうでない場合は503を返します。

コンテンツブロックのタイプ

JSONL出力にはセマンティックコンテンツブロックが含まれます。

セキュリティ

SSRF保護

ブロックされる宛先には次が含まれます。

• ローカルホストとループバックアドレス
• プライベートIP範囲 (10.x.x.x, 172.16-31.x.x, 192.168.x.x)
• クラウドメタデータエンドポイント (AWS、GCP、Azure)
• IPv6のリンクローカルおよび一意のローカルアドレス
• .local や .internal などの内部サフィックス

URL検証

• http および https URLのみ
• URLに埋め込まれた資格情報はなし
• 最大URL長: 2048文字

ヘッダーサニタイズ

ブロックされるヘッダー: host, authorization, cookie, x-forwarded-for, x-real-ip, proxy-authorization

レート制限

デフォルト: 100リクエスト/分 ごとのIP (HTTPモードのみ)。RATE_LIMIT_MAX と RATE_LIMIT_WINDOW_MS で設定します。

開発

スクリプト

テクノロジースタック

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します: git checkout -b feature/amazing-feature
3. リントが通過することを確認します: npm run lint
4. テストを実行します: npm test
5. 変更をコミットします: git commit -m 'Add amazing feature'
6. プッシュします: git push origin feature/amazing-feature
7. プルリクエストを開きます。

他のMCPサーバーの例については、github.com/modelcontextprotocol/servers を参照してください。