MCP Node DuckDuckGo Server

MCP Node DuckDuckGo Server

site icon
2025.04.16 0
JavaScript搜索工具网页内容抓取搜索工具
MCP Node DuckDuckGo Server 是一个基于 Node.js 的 MCP 服务器,提供两种主要工具:搜索和网页内容抓取。它通过 HTTP 端点提供模块化接口,支持查询 DuckDuckGo 并获取格式化的搜索结果,以及从任意网页 URL 抓取和解析文本内容。
View on GitHub

Overview

基本能力

产品定位

MCP Node DuckDuckGo Server 是一个专注于搜索和网页内容抓取的 MCP 服务器,适用于需要集成 DuckDuckGo 搜索或网页内容解析的应用场景。

核心功能

  • DuckDuckGo 搜索:通过 POST API 执行搜索查询,返回格式化的 DuckDuckGo 搜索结果。
  • 网页内容抓取:从给定 URL 抓取并解析文本内容。
  • 速率限制:提供基本的速率限制功能,管理请求频率。
  • 可扩展的 MCP 服务器:工具以模块化方式组织,便于添加或修改功能。

适用场景

  • 需要集成 DuckDuckGo 搜索的应用。
  • 需要从网页抓取并解析文本内容的应用。
  • 需要模块化接口的 MCP 服务器开发。

工具列表

  • Search Tool:执行 DuckDuckGo 搜索并返回格式化结果。
  • Fetch Content Tool:从网页 URL 抓取并解析文本内容。

常见问题解答

  • 调试:服务器日志会记录信息和错误消息,可用于调试超时、HTTP 错误或响应中的意外行为。
  • 贡献:欢迎通过 Fork 仓库、创建特性分支、提交更改并推送分支后发起 Pull Request 来贡献代码。

使用教程

使用依赖

  • Node.js (v12 或更高版本)
  • npm

安装教程

  1. 克隆仓库 bash git clone <repository-url>
  2. 进入项目文件夹 bash cd mcp-node-duckduckgo-server
  3. 安装依赖 bash npm install express axios cheerio

调试方式

  1. 启动服务器 bash node mcp-node-duckduckgo-server.js
  2. 列出工具 bash curl http://localhost:3000/tools
  3. 使用搜索工具 bash curl -X POST http://localhost:3000/run-tool -H "Content-Type: application/json" -d "{\"toolName\":\"search\",\"params\":{\"query\":\"test query\",\"maxResults\":5}}"
  4. 使用内容抓取工具 bash curl -X POST http://localhost:3000/run-tool -H "Content-Type: application/json" -d "{\"toolName\":\"fetchContent\",\"params\":{\"url\":\"https://www.channelnewsasia.com/singapore/ge2025-general-election-may-3-parliament-dissolved-5064316\"}}"

许可证

该项目遵循 MIT 开源许可条款。