MCP Node Duckduckgo

🚀 MCP Node DuckDuckGo 服務器

MCP Node DuckDuckGo 服務器是一個基於 Node.js 的應用程序，作為 MCP（模塊化控制平臺）服務器運行。它主要提供兩個實用工具，一是可查詢 DuckDuckGo 並獲取格式化的搜索結果；二是能從指定的網頁 URL 抓取並解析文本內容，為信息獲取和處理提供了便利。

🚀 快速開始

MCP Node DuckDuckGo 服務器是一個基於 Node.js 的服務器，通過 HTTP 端口提供對 DuckDuckGo 搜索和網頁內容抓取的功能。此項目展示瞭如何使用 Express 創建服務器、使用 Axios 進行 HTTP 請求以及使用 Cheerio 解析 HTML。

安裝指南

1. 克隆倉庫

從 GitHub 克隆倉庫：

git clone <倉庫地址>

2. 進入項目文件夾

cd mcp-node-duckduckgo-server

3. 安裝依賴項

使用 npm 安裝所需包：

npm install express axios cheerio

啟動服務器

運行服務器，執行以下命令：

node mcp-node-duckduckgo-server.js

你應該會看到類似以下的日誌消息：

MCP 服務器 "ddg-search" 在端口3000上運行

✨ 主要特性

• DuckDuckGo 搜索：利用 POST API 執行搜索查詢，並返回格式化的 DuckDuckGo 結果，便於進一步處理。
• 網頁內容抓取：從指定 URL 獲取並解析文本內容。
• 速率限制：提供基本的速率限制功能，管理請求頻率。
• 可擴展性 MCP 服務器：工具按模塊組織，方便添加或修改功能。

💻 使用示例

可用端點

列出工具

要列出所有可用工具，請打開新的終端窗口並運行：

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 錯誤或響應中的意外行為。

貢獻指南

歡迎貢獻！如果希望參與：

1. 復刻倉庫。
2. 創建功能分支（git checkout -b feature/YourFeature）。
3. 提交更改（git commit -m '添加某個功能'）。
4. 推送到分支（git push origin feature/YourFeature）。
5. 打開拉取請求。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參閱LICENSE文件。