Search Fetch Server MCP

🚀 検索取得サーバー MCP サーバー

TypeScript ベースの MCP サーバーで、シンプルなノートシステムを実装しています。このサンプルを通じて、以下を含む核心的な MCP 概念をデモンストレーションしています。

• リソース：メタデータ付きのテキストノートを note:// URI で表現
• ツール：新しいノートの作成、URL の取得、検索の実行に使用
• プロンプト：保存されたすべてのノートの要約を生成

✨ 主な機能

リソース

• note:// URI 付きのノートを一覧表示およびアクセス
• 各ノートにはタイトル、内容、メタデータが含まれる
• plain text mime type を使用して簡単に内容にアクセス

ツール

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

プロンプト

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

🔧 開発

依存関係をインストールする：

npm install

サーバーをビルドする：

npm run build

自動再構築を伴う開発：

npm run watch

📦 インストール

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 スクリプトで実行できます。

npm run inspector

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