Nexon33 Search Fetch Server MCP

🚀 Search Fetch Server MCP Server

This is a TypeScript-based MCP server that implements a simple note-taking system. It demonstrates core MCP concepts in the following ways:

• Resources represent text notes with URIs and metadata.
• Tools are used to create new notes, fetch URLs, and perform searches.
• Prompts generate note summaries.

✨ Features

Resources

• List and access notes via note:// URIs.
• Each note has a title, content, and metadata.
• Use the plain text MIME type for simple content access.

Tools

• create_note - Create a new text note:
  • Accepts a title and content as required parameters.
  • Stores the note in the server state.
• fetch_url - Fetch content from a URL, optionally converting it to Markdown using Puppeteer:
  • Receives a URL as a required parameter.
  • Receives an optional use_puppeteer boolean parameter. If true, it uses Puppeteer with waitUntil set to networkidle2 and a 30-second timeout. Otherwise, it uses axios.
  • Returns the URL content as Markdown (if Puppeteer is used), otherwise returns the content itself.
• duckduckgo_search - Perform a DuckDuckGo search:
  • Receives a query as a required parameter.
  • Returns search results as a JSON string.

Prompts

• summarize_notes - Generate a summary of all stored notes:
  • Includes all note content as embedded resources.
  • Returns a structured prompt for an LLM to summarize.

📦 Installation

Install Dependencies

npm install

Build the Server

npm run build

Development with Automatic Rebuild

npm run watch

Configuration for Claude Desktop

To use it with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Debugging

Since MCP servers communicate via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in the browser.