笔记搜索服务

一个基于TypeScript的MCP服务器,提供笔记创建、URL内容抓取和DuckDuckGo搜索功能,适用于内容管理和信息检索场景。

  • by nexon33
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nexon33/search-fetch-server-mcp

使用说明

搜索获取服务器MCP服务器

模型上下文协议服务器

这是一个基于TypeScript的MCP服务器,实现了一个简单的笔记系统。它通过提供以下内容展示了MCP的核心概念:

  • 用URI和元数据表示文本注释的资源
  • 用于创建新笔记、获取URL和执行搜索的工具
  • 提示生成笔记摘要

特性

资源

  • 通过以下方式列出和访问笔记 note:// URI
  • 每个注释都有一个标题、内容和元数据
  • 纯文本mime类型,用于简单的内容访问

工具

  • create_note -创建新的文本注释
    • 将标题和内容作为所需参数
    • 以服务器状态存储笔记
  • fetch_url -从URL获取内容,并可选择使用Puppeteer转换为markdown
    • 将URL作为必需参数
    • 取一个可选项 use_puppeteer 布尔参数。如果是真的,它将使用木偶师 waitUntil 着手 networkidle2 超时30秒。否则,它将使用轴。
    • 如果使用puppeteer,则以markdown形式返回URL的内容,否则按原样返回内容。
  • 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检查员,可作为包脚本使用:

npm run inspector

检查器将提供一个URL,用于访问浏览器中的调试工具。