Nexon33 Search Fetch Server MCP

🚀 搜索抓取服務器 MCP 服務端

這是一個基於 TypeScript 的 MCP 服務器，實現了一個簡單的筆記系統。它通過資源表示、工具操作和提示生成等方式，演示了核心的 MCP 概念，能幫助用戶高效管理和處理文本筆記。

🚀 快速開始

本項目是一個基於 TypeScript 的 MCP 服務器，實現了簡單的筆記系統。若要使用該服務器，需完成依賴安裝、服務器構建等步驟，以下是詳細操作說明。

✨ 主要特性

資源

• 通過 note:// URI 列出和訪問筆記，方便快捷。
• 每個筆記都有標題、內容和元數據，便於分類和管理。
• 使用純文本 MIME 類型進行簡單的內容訪問，降低操作複雜度。

工具

• create_note：創建新的文本筆記。
  • 接受標題和內容作為必填參數。
  • 將筆記存儲在服務器狀態中。
• fetch_url：從 URL 獲取內容，可選使用 Puppeteer 轉換為 Markdown。
  • 接收一個 URL 作為必填參數。
  • 接收一個可選的 use_puppeteer 布爾參數。若為 true，則使用帶有 waitUntil 設置為 networkidle2 和 30 秒超時的 Puppeteer；否則，將使用 axios。
  • 返回 URL 內容作為 Markdown（若使用了 Puppeteer），否則返回內容本身。
• 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。