search-fetch-server MCP Server

search-fetch-server MCP サーバー

Model Context Protocol サーバーです。

これは、シンプルなメモシステムを実装した 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 で使用するには、サーバーの設定を追加します。

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 を提供します。