search-fetch-server MCP Server

search-fetch-server MCP Server

site icon
2024.12.27 0
Python笔记管理URL 内容获取搜索功能搜索工具内容生成
search-fetch-server MCP Server 是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统。它通过提供文本笔记的创建、URL 内容的获取和搜索功能,展示了 MCP 的核心概念。该服务器支持通过 URI 访问笔记,每个笔记包含标题、内容和元数据,并且提供了创建笔记、获取 URL 内容和执行 DuckDuckGo 搜索的工具。此外,还提供了生成笔记摘要的提示功能。
View on GitHub

Overview

基本能力

产品定位

search-fetch-server MCP Server 是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统,主要用于文本笔记的创建、URL 内容的获取和搜索功能。

核心功能

  • 资源管理:通过 note:// URI 列出和访问笔记,每个笔记包含标题、内容和元数据。
  • 工具
  • create_note:创建新的文本笔记,需要标题和内容作为参数。
  • fetch_url:从 URL 获取内容,可选择使用 Puppeteer 转换为 markdown 或直接使用 axios 获取原始内容。
  • duckduckgo_search:执行 DuckDuckGo 搜索,返回 JSON 格式的搜索结果。
  • 提示功能summarize_notes 生成所有存储笔记的摘要,返回结构化提示供 LLM 摘要使用。

适用场景

  • 需要快速创建和管理文本笔记的场景。
  • 需要从 URL 获取内容并转换为 markdown 的场景。
  • 需要执行 DuckDuckGo 搜索并获取搜索结果的场景。
  • 需要生成笔记摘要的场景。

工具列表

  • create_note:创建新的文本笔记。
  • fetch_url:获取 URL 内容,支持 Puppeteer 和 axios 两种方式。
  • duckduckgo_search:执行 DuckDuckGo 搜索。

常见问题解答

  • 调试问题:由于 MCP 服务器通过 stdio 通信,调试较为困难。推荐使用 MCP Inspector 进行调试,可以通过 npm run inspector 启动。

使用教程

使用依赖

安装依赖:

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 Inspector 进行调试:

npm run inspector

许可证

None