🚀 MCP Node DuckDuckGo 服务器
MCP Node DuckDuckGo 服务器是一个基于 Node.js 的应用程序，作为 MCP（模块化控制平台）服务器运行。它主要提供两个实用工具，一是可查询 DuckDuckGo 并获取格式化搜索结果的搜索工具，二是能从指定网页 URL 抓取并解析文本内容的获取内容工具。
🚀 快速开始
MCP Node DuckDuckGo 服务器通过 HTTP 端口提供对 DuckDuckGo 搜索和网页内容抓取的功能。以下是启动服务器的步骤：
- 运行服务器，执行以下命令：
node mcp-node-duckduckgo-server.js
- 你应该会看到类似以下的日志消息：
MCP 服务器 "ddg-search" 在端口3000上运行
✨ 主要特性
- DuckDuckGo 搜索：利用 POST API 执行搜索查询，并返回格式化的 DuckDuckGo 结果，便于进一步处理。
- 网页内容抓取：从指定 URL 获取并解析文本内容。
- 速率限制：提供基本的速率限制功能，管理请求频率。
- 可扩展性 MCP 服务器：工具按模块组织，方便添加或修改功能。
📦 安装指南
环境要求
- Node.js（v12 或更高版本）
- npm
安装步骤
- 克隆仓库 从 GitHub 克隆仓库：
git clone <仓库地址>
- 进入项目文件夹
cd mcp-node-duckduckgo-server
- 安装依赖项 使用 npm 安装所需包：
npm install express axios cheerio
💻 使用示例
基础用法
列出工具
要列出所有可用工具，请打开新的终端窗口并运行：
curl http://localhost:3000/tools
这将输出一个 JSON 列表，显示注册的工具（例如，“search”和“fetchContent”）。
搜索工具
使用搜索工具执行搜索查询：
curl -X POST http://localhost:3000/run-tool -H "Content-Type: application/json" -d "{\"toolName\":\"search\",\"params\":{\"query\":\"测试查询\",\"maxResults\":5}}"
响应将包含来自 DuckDuckGo 的格式化搜索结果。
获取内容工具
从指定网页获取内容：
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\"}}"
服务器将返回从抓取网页中提取的文本片段。
📚 详细文档
日志和调试
- 服务器将信息日志和错误日志输出到终端。
- 使用这些日志帮助排查问题，例如超时、HTTP 错误或响应中的意外行为。
贡献指南
欢迎贡献！如果希望参与：
- 复刻仓库。
- 创建功能分支（
git checkout -b feature/YourFeature）。 - 提交更改（
git commit -m '添加某个功能'）。 - 推送到分支（
git push origin feature/YourFeature）。 - 打开拉取请求。
📄 许可证
本项目遵循 MIT 许可证，具体内容请参阅LICENSE文件。