Traylinx Search Engine MCP Server

🚀 Traylinx 搜索引擎 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーであり、デプロイされた Agentic 検索 API のブリッジとして機能します。Claude Desktop や Cursor などの MCP クライアントが、詳細なテキスト要約や構造化データ（HTML、画像など）を提供するスマート検索機能を利用できるようにします。

✨ 主な機能

🔍 search ツール

Traylinx の API を使用してウェブ検索を実行します。この API は、詳細でコンテキストに関連した結果を参照付きで提供します。デフォルトでは時間フィルターは適用されません。

入力項目：

• query (文字列)：実行する検索クエリです。
• search_recency_filter (文字列、オプション)：検索結果を時間でフィルタリングします。選択肢は "month"、"week"、"day"、"hour" です。指定されない場合、デフォルトで時間フィルターは適用されません。

📚 詳細ドキュメント

仕組み

1. プロジェクトの概要：Traylinx 検索エンジン MCP サーバーは、MCP クライアントと Agentic 検索 API を接続するブリッジとして機能します。
2. ツールの説明：search ツールを使用すると、MCP クライアントからウェブ検索を実行し、詳細な結果を取得できます。
3. 動作フロー：
   • 検索クエリを受け取ります。
   • Agentic 検索 API を呼び出します。
   • 応答を処理し、MCP クライアントで使用できるようにフォーマットします。

インストール手順

1. プロジェクトの概要：Traylinx 検索エンジン MCP サーバーは、MCP クライアントと Agentic 検索 API を接続するブリッジとして機能します。
2. ツールの説明：search ツールを使用すると、MCP クライアントからウェブ検索を実行し、詳細な結果を取得できます。
3. 動作フロー：
   • 検索クエリを受け取ります。
   • Agentic 検索 API を呼び出します。
   • 応答を処理し、MCP クライアントで使用できるようにフォーマットします。

設定ガイド

環境変数の設定

サーバーの動作を設定するには、以下の環境変数を設定します。

• AGENTIC_SEARCH_API_KEY：Agentic 検索 API のキーで、必須項目です。
• AGENTIC_SEARCH_ENDPOINT：Agentic 検索 API のエンドポイント URL をカスタマイズします。デフォルト値はデフォルトのエンドポイントです。

設定ファイルの例

{
  "environmentVariables": {
    "AGENTIC_SEARCH_API_KEY": "your_api_key_here",
    "AGENTIC_SEARCH_ENDPOINT": "https://api.agents.com/v1"
  }
}

検証方法

手動テスト

以下のコマンドを実行して、サーバーが正常に動作していることを確認します。

curl -X POST http://localhost:3000/api/search \
     -H "Content-Type: application/json" \
     -d '{"query": "latest tech news", "search_recency_filter": "day"}'

自動化テストスクリプト

const fetch = require('node-fetch');

async function testSearch() {
    const response = await fetch('http://localhost:3000/api/search', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            query: "latest tech news",
            search_recency_filter: "day"
        })
    });
    
    const data = await response.json();
    console.log(data);
}

testSearch();

高度な使用例

複数のコンテンツタイプの返却

サーバーは以下のコンテンツタイプをサポートしています。

• テキスト要約：簡潔な検索結果です。
• 構造化データ：URL、タイトル、説明です。
• ニュース記事：タイムスタンプとサムネイル付きの記事です。

時間フィルターの使用例

{
  "name": "search",
  "arguments": {
    "query": "SpaceX 発射",
    "search_recency_filter": "week"
  }
}

デプロイ情報

Smithery.ai でのデプロイ

Smithery.ai でデプロイするには、以下の手順を実行します。

1. Smithery アカウントにログインまたは登録します。
2. 「新しい MCP サーバー」をクリックします。
3. ID を traylinx-search-engine-mcp-server と入力します。
4. ベースディレクトリをルートディレクトリに設定します。
5. 「作成」をクリックします。

トラブルシューティング

• 問題1：API に接続できない場合

  • ネットワーク接続と API アドレスが正しいことを確認してください。

• 問題2：検索結果が得られない場合

  • API キーが有効で、正しく設定されていることを確認してください。

• ログ記録：

  • LOG_LEVEL を DEBUG に設定すると、詳細なログ情報を取得できます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。