MCP Node Duckduckgo

🚀 MCP Node DuckDuckGo サーバー

このアプリケーションはNode.jsベースで、MCP（モジュール化制御プラットフォーム）サーバーとして動作します。主に2つのツールを提供します。

• 検索：DuckDuckGoを検索し、整形された検索結果を取得します。
• コンテンツ取得：指定したウェブページのURLからテキストコンテンツを取得して解析します。

🚀 クイックスタート

MCP Node DuckDuckGoサーバーは、Node.jsベースのサーバーで、HTTPポートを通じてDuckDuckGo検索とウェブページコンテンツの取得機能を提供します。このプロジェクトでは以下のことが示されています。

• Expressを使用してサーバーを作成する方法。
• Axiosを使用してHTTPリクエストを行う方法。
• Cheerioを使用してHTMLを解析する方法。

✨ 主な機能

• DuckDuckGo検索：POST APIを利用して検索クエリを実行し、整形されたDuckDuckGoの検索結果を返し、さらなる処理を容易にします。
• ウェブページコンテンツの取得：指定したURLからテキストコンテンツを取得して解析します。
• レート制限：基本的なレート制限機能を提供し、リクエストの頻度を管理します。
• 拡張可能なMCPサーバー：ツールはモジュール化されており、機能の追加や変更が容易です。

📦 インストール

必要条件

• Node.js（v12以上）
• npm

インストール手順

1. リポジトリをクローンする GitHubからリポジトリをクローンします。

   git clone <リポジトリのURL>
   

2. プロジェクトフォルダに移動する

   cd mcp-node-duckduckgo-server
   

3. 依存関係をインストールする npmを使用して必要なパッケージをインストールします。

   npm install express axios cheerio
   

💻 使用例

サーバーの起動

以下のコマンドを実行してサーバーを起動します。

node mcp-node-duckduckgo-server.js

以下のようなログメッセージが表示されるはずです。

MCP サーバー "ddg-search" がポート3000で起動しました

利用可能なエンドポイント

ツールの一覧表示

利用可能なすべてのツールを一覧表示するには、新しいターミナルウィンドウを開き、以下のコマンドを実行します。

curl http://localhost:3000/tools

これにより、登録されているツール（例："search" や "fetchContent"）を示すJSONリストが出力されます。

検索ツール

検索ツールを使用して検索クエリを実行するには、以下のコマンドを実行します。

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ファイルを参照してください。