LinkupPlatform-linkup-mcp-server

Linkup MCP サーバー

Linkup の高度な API を通じて、ウェブ検索とページ取得機能を提供する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude などの AI アシスタントが自然言語のクエリで高度なウェブ検索を実行し、あらゆるウェブページからコンテンツを取得して、ウェブ上の信頼できる情報源からリアルタイム情報にアクセスできます。

機能

• 🔍 リアルタイムウェブ検索：最新の情報、ニュース、データをウェブで検索します
• 🧠 詳細なリサーチ：複数の情報源を対象とする時間のかかるリサーチタスクを開始し、結果をポーリングします
• 🌐 ページ取得：あらゆるウェブページからコンテンツを取得して抽出します
• 🎯 自然言語クエリ：最良の結果を得るには、質問文をそのまま使います
• 📊 柔軟な検索深度：
  • standard - 直接的な回答が得られるクエリ向け
  • deep - 複数の情報源を横断して分析する複雑なリサーチ向け
• 🎯 結果の絞り込み：ドメイン（includeDomains / excludeDomains）、日付範囲（fromDate / toDate）、maxResults で結果を絞り込みます
• 🖼️ 画像の結果：検索では任意の includeImages、取得では任意の extractImages を指定できます
• 🖥️ JavaScript レンダリング：動的コンテンツ向けに任意で JS レンダリングを有効にできます
• 📄 生の HTML：未処理のページが必要な場合、取得時に任意で includeRawHtml を指定できます
• ⚡ 高速：Linkup の最適化されたインフラストラクチャを利用しています

インストール

• Cursor、VSCode、Claude Code、Codex、またはその他の MCP 対応クライアント
• Linkup API キー

API キーの取得

1. app.linkup.so で無料の Linkup アカウントを作成します
2. ダッシュボードから API キーをコピーします

リモート MCP サーバー（推奨）

ホストされた Linkup MCP サーバーは Streamable HTTP トランスポートを使用します。クライアントがリモート HTTP MCP サーバーに対応している場合は、ホストされたエンドポイントを直接指定できます。

クライアントがカスタム HTTP ヘッダーに対応している場合は、API キーを URL に含めるのではなく、Authorization: Bearer LINKUP_API_KEY で送信することをおすすめします。カスタムヘッダーを送信できないクライアントでは、?apiKey=... クエリパラメーターも引き続き使用できます。

Cursor

~/.cursor/mcp.json ファイルに次の内容を追加します：

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "type": "http",
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
    }
  }
}

VSCode

VS Code の MCP 設定ファイルに次の内容を追加します。詳しくはVS Code MCP ドキュメントを参照してください。

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY",
      "type": "http"
    }
  }
}

Codex

Codex は、config.toml を介してリモート HTTP MCP サーバーとカスタム HTTP ヘッダーの両方に対応しています。

環境変数のベアラートークンを使用する場合：

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp"
bearer_token_env_var = "LINKUP_API_KEY"
enabled = true

または、クエリパラメーターを引き続き使用する場合：

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
enabled = true

MCP Bundle（Claude Desktop におすすめ）

Claude Desktop など、互換性のある MCP クライアントで動作する自己完結型パッケージ、ビルド済みの MCP Bundle をダウンロードします。MCP Bundle は Anthropic が開発しています。詳しくはMCP Bundles リポジトリを参照してください。

クイックダウンロード：

curl -L -o linkup-mcp-server.mcpb https://github.com/LinkupPlatform/linkup-mcp-server/releases/latest/download/linkup-mcp-server.mcpb

インストール：

1. リリースから linkup-mcp-server.mcpb をダウンロードします（または上記の curl コマンドを使用します）
2. ファイルをクリックしてインストールします
3. プロンプトが表示されたら API キーを設定します

ローカル MCP サーバー

stdio トランスポートを使用して、MCP サーバーをローカルで実行することもできます。

Cursor

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

VSCode

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

Codex

[mcp_servers.linkup]
command = "npx"
args = ["-y", "linkup-mcp-server", "apiKey=LINKUP_API_KEY"]
enabled = true

使用方法

設定が完了したら、AI エージェントにウェブ検索やウェブページのコンテンツ取得を依頼できます。

検索例：

• 「AI の最新動向に関するニュースをウェブで検索して」
• 「東京の現在の天気は？」
• 「新しい EU AI Act に関する情報と、スタートアップへの影響を調べて」
• 「NVIDIA の最新の株価を検索して」

リサーチ例：

• 「Microsoft、Amazon、Google の 2024 年のクラウド収益成長率を比較して」

リサーチは時間のかかる処理で、通常は数分かかります。エージェントは linkup-research でタスクを開始し、返されたタスクの id を使って、ステータスが completed または failed になるまで linkup-get-research をポーリングします。

取得例：

• 「https://example.com/article のコンテンツを取得して」
• 「このブログ記事のコンテンツを取得して要約して：https://blog.example.com/post」
• 「JavaScript レンダリングを有効にして https://example.com を取得して」

検索の深さ

• 標準検索：直接回答できるクエリ（天気、株価、簡単な事実など）に最適です
• 詳細検索：複数の情報源を分析する必要がある複雑なリサーチ（包括的なガイド、比較分析、詳細な調査など）に最適です

利用可能なツール

linkup-search

Linkup を使用してウェブをリアルタイムで検索し、信頼できる情報源から最新の情報、事実、ニュースを取得します。

パラメーター：

• query（必須）：自然言語の検索クエリです。質問文にすると最適な結果が得られます。
• depth（任意）：検索の深さです。"standard"（デフォルト）または "deep" を指定します。
• includeImages（任意、デフォルトは false）：テキストの検索結果とともに、関連画像を URL とメタデータ付きで返します。
• includeDomains（任意）：検索対象を限定するドメインの配列です。例：["bbc.com", "reuters.com"]。指定できるドメインは最大 100 件です。
• excludeDomains（任意）：検索対象から除外するドメインの配列です。例：["reddit.com", "quora.com"]。
• fromDate（任意）：この日付以降に公開されたコンテンツのみを含めます。形式は YYYY-MM-DD です。
• toDate（任意）：この日付以前に公開されたコンテンツのみを含めます。形式は YYYY-MM-DD です。
• maxResults（任意）：返す結果の最大数です（正の整数）。

ユースケース：

• リアルタイムデータ（天気、株価、スポーツのスコア、イベント）
• 速報や時事情報
• 最近の研究や出版物
• 製品情報や最新価格
• スケジュールや利用状況
• AI のナレッジベースにないあらゆる情報

linkup-research

自律型のLinkupリサーチタスクを送信します。これは、単一の検索クエリでは解決できない質問に答えるため、ウェブを調査するエージェントで、複数の情報源を統合し、出典を明記した回答を返します。検証済みの正確な回答、特定のテーマに焦点を当てた調査、または複数の視点からの幅広いレポートが必要な場合に使用します。非同期で時間のかかる処理（数分かかる場合があります）のため、最終結果ではなくタスクのidとstatusをすぐに返します。完了状況の確認にはlinkup-get-researchを使用してください。

パラメーター：

• query（必須）：自然言語で記述した調査の質問です。詳細で具体的な質問が最適です。
• mode（任意）：調査の種類を指定します。正確で根拠に基づく回答には"answer"、1つのテーマに関する詳細なレポートには"investigate"、多くのトピックにわたる構成されたレポートには"research"を使用してください。省略すると、Linkupが質問を分類します。
• reasoningDepth（任意）：処理時間と網羅性のバランスを決める、タスクの推論量です。軽い調査には"S"、バランスの取れた調査には"M"、徹底的な調査には"L"（デフォルト）、網羅的な調査には"XL"を使用してください。
• includeDomains（任意）：結果を限定するドメインの配列です。例：["bbc.com", "reuters.com"]。設定を推奨します。最大100ドメインです。
• excludeDomains（任意）：結果から除外するドメインの配列です。例：["reddit.com", "quora.com"]。
• fromDate（任意）：この日付以降に公開されたコンテンツのみを対象にします。形式はYYYY-MM-DDです。
• toDate（任意）：この日付以前に公開されたコンテンツのみを対象にします。形式はYYYY-MM-DDです。

ユースケース：

• 包括的な調査レポートや比較分析
• 多数の情報源を統合する必要のある調査
• 簡単な検索では不十分な複雑な質問

linkup-get-research

linkup-researchで開始した調査タスクの現在の状態を取得します。

パラメーター：

• id（必須）：linkup-researchが返した調査タスクのIDです。

動作：

• タスクオブジェクトを返します。オブジェクトにはstatus（pending、processing、completed、failed）が含まれます。
• pendingまたはprocessingの間は、終端状態になるまで数秒おきにポーリングを続けてください。1秒未満の間隔でポーリングすると、レート制限が適用されます。
• completedの場合、結果はoutputフィールドに含まれます。failedの場合、理由はerrorフィールドに含まれます。

linkup-fetch

任意のウェブページURLからコンテンツを取得し、抽出します。

パラメーター：

• url（必須）：コンテンツを取得するURLです。
• renderJs（任意、デフォルトはfalse）：JavaScriptコンテンツをレンダリングするかどうかを指定します。JavaScriptでコンテンツを読み込む動的なページでは有効にしてください。注：リクエストが遅くなります。
• extractImages（任意、デフォルトはfalse）：ページ内の画像を抽出し、専用のimagesフィールドに返すかどうかを指定します。後続の処理や分析のために、すべての画像の一覧が必要な場合に便利です。
• includeRawHtml（任意、デフォルトはfalse）：ページの未加工のHTMLを専用のrawHtmlフィールドに含めるかどうかを指定します。独自のHTML解析、特定の書式の保持、または通常のコンテンツ抽出で除外される可能性のある要素へのアクセスに便利です。

ユースケース：

• 分析や要約のためにページコンテンツを取得する
• ニュースサイトから記事の内容を抽出する
• 技術系ウェブサイトからドキュメントを取得する
• ブログ記事や文章コンテンツを取得する

開発

前提条件

• Node.js >= 24.0.0
• npm

セットアップ

# Install dependencies
npm install

HTTP サーバーの実行

npm run dev

これにより、ローカルのStreamable HTTPサーバーがhttp://localhost:2121/mcpで起動します。

stdioトランスポートでの実行

npm run build:stdio
npm run start:stdio -- apiKey=YOUR_API_KEY

ローカル開発では、環境変数を介してキーを渡すこともできます。

LINKUP_API_KEY=YOUR_API_KEY npm run start:stdio

MCP Inspectorでのテスト

npm run build:stdio
npm run inspector -- apiKey=YOUR_API_KEY

ブラウザーでMCP Inspectorが開き、検索ツールを対話的にテストできます。

ライセンス

MIT

リンク

• Linkupのウェブサイト
• Linkupのドキュメント
• Model Context Protocol

サポート

問題が発生した場合は、[email protected] までメールでお問い合わせいただくか、Discord サーバー にご参加ください。