search-fetch-server MCP 服务器使用说明

项目简介

search-fetch-server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它作为一个简单的示例，展示了如何使用 MCP 协议来管理资源、工具和 Prompt。该服务器实现了一个简单的笔记系统，并集成了网页内容抓取和 DuckDuckGo 搜索功能，旨在帮助开发者理解和应用 MCP 协议。

主要功能点

资源 (Resources):
- 提供对文本笔记的列表和访问功能，每篇笔记通过 'note://' URI 进行标识。
- 笔记包含标题、内容和元数据，内容类型为纯文本。
工具 (Tools):
- 'create_note': 创建新的文本笔记，需要提供标题和内容。
- 'fetch_url': 抓取指定 URL 的网页内容，并可选择使用 Puppeteer 进行渲染和转换为 Markdown 格式，或使用 axios 直接获取原始内容。
- 'duckduckgo_search': 使用 DuckDuckGo 搜索引擎进行搜索，返回 JSON 格式的搜索结果。
Prompt 模板 (Prompts):
- 'summarize_notes': 生成所有笔记的摘要 Prompt，用于指导 LLM 总结笔记内容。

安装步骤

安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 将仓库 'MCP-Mirror/nexon33_search-fetch-server-mcp' 克隆到本地。

git clone https://github.com/MCP-Mirror/nexon33_search-fetch-server-mcp.git
cd nexon33_search-fetch-server-mcp

安装依赖: 在仓库目录下运行以下命令安装项目依赖。
```
npm install
```
构建项目: 运行以下命令构建服务器代码。
```
npm run build
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要配置客户端以连接到此服务器。以下是 Claude Desktop 的配置示例，您需要将配置添加到 'claude_desktop_config.json' 文件中。

配置文件路径:

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

配置内容 (添加到 'mcpServers' 字段):

{
  "mcpServers": {
    "search-fetch-server": {  // 服务器名称，客户端配置中引用此名称
      "command": "node",      // 启动服务器的命令，这里使用 node 解释器
      "args": [             // 命令参数
        "/path/to/search-fetch-server-mcp/build/index.js" // index.js 文件的绝对路径，请替换为实际路径
      ]
    }
  }
}

注意:

请将 '/path/to/search-fetch-server-mcp/build/index.js' 替换为 'search-fetch-server-mcp' 仓库 'build/index.js' 文件的实际绝对路径。
确保 Claude Desktop 能够访问到 'node' 命令和 'index.js' 文件。

基本使用方法

启动服务器: 配置完成后，当 MCP 客户端（如 Claude Desktop）启动时，会自动尝试连接并启动配置的 MCP 服务器。
客户端交互: 在 MCP 客户端中，您应该能够：
- 列出和访问由 'search-fetch-server' 提供的笔记资源（通常在客户端的资源管理或上下文信息浏览功能中）。
- 调用 'search-fetch-server' 提供的工具，例如 'create_note', 'fetch_url', 'duckduckgo_search'（通常在客户端的工具调用或功能扩展界面中）。
- 使用 'search-fetch-server' 提供的 Prompt 模板，例如 'summarize_notes'，来生成用于 LLM 交互的 Prompt（通常在客户端的 Prompt 管理或自定义功能中）。
调试: 如果遇到问题，可以使用仓库提供的 Inspector 工具进行调试，运行命令 'npm run inspector' 并在浏览器中打开 Inspector 提供的 URL。

通过以上步骤，您就可以成功安装、配置和使用 'search-fetch-server' MCP 服务器，体验其提供的资源、工具和 Prompt 功能。

关键词