Nexon33 Search Fetch Server MCP

🚀 検索収集サーバー MCP サーバー

これは TypeScript をベースとした MCP サーバーで、簡単なノートシステムを実装しています。以下の方法で核心的な MCP 概念をデモンストレーションしています。

• リソースは URI とメタデータを持つテキストノートを表します。
• ツールは新しいノートの作成、URL の取得、検索の実行に使用されます。
• プロンプトはノートの要約を生成します。

✨ 主な機能

リソース

• note:// URI を通じてノートを一覧表示およびアクセスできます。
• 各ノートにはタイトル、内容、メタデータがあります。
• 単純な内容アクセスには純粋なテキスト MIME タイプを使用します。

ツール

• create_note - 新しいテキストノートを作成します。
  • タイトルと内容を必須パラメータとして受け取ります。
  • ノートをサーバーの状態に保存します。
• fetch_url - URL から内容を取得し、必要に応じて Puppeteer を使用して Markdown に変換します。
  • URL を必須パラメータとして受け取ります。
  • オプションの use_puppeteer ブールパラメータを受け取ります。true の場合、waitUntil を networkidle2 に設定し、30 秒のタイムアウトで Puppeteer を使用します。それ以外の場合は axios を使用します。
  • Puppeteer を使用した場合は URL の内容を Markdown として返し、それ以外の場合は内容自体を返します。
• duckduckgo_search - DuckDuckGo 検索を実行します。
  • クエリを必須パラメータとして受け取ります。
  • 検索結果を JSON 文字列として返します。

プロンプト

• summarize_notes - 保存されたすべてのノートの要約を生成します。
  • すべてのノート内容を埋め込みリソースとして含みます。
  • LLM で要約するための構造化されたプロンプトを返します。

📦 インストール

開発環境のセットアップ

依存関係をインストールするには、以下のコマンドを実行します。

npm install

サーバーをビルドするには、以下のコマンドを実行します。

npm run build

自動再構築を伴う開発を行うには、以下のコマンドを実行します。

npm run watch

Claude Desktop との連携

Claude Desktop と一緒に使用するには、サーバー設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "search-fetch-server": {
      "command": "node",
      "args": ["/path/to/search-fetch-server/build/index.js"]
    }
  }
}

デバッグ

MCP サーバーは stdio を通じて通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用可能です。

npm run inspector

Inspector はブラウザでアクセスできるデバッグツールの URL を提供します。