
search-fetch-server MCP Server

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