Synthetic Web Search MCP

🚀 合成ウェブ検索MCPサーバー

Model Context Protocol (MCP)サーバーで、合成ウェブ検索APIをClaudeやその他のMCP互換アプリケーションで使用できるツールとして公開します。

🚀 クイックスタート

Claude Codeでのクイックスタート

1つのコマンドでClaude CodeにMCPサーバーを追加します。

claude mcp add synthetic-web-search -e SYNTHETIC_API_KEY=your_api_key_here -- npx -y synthetic-web-search-mcp@latest

your_api_key_here を実際の Synthetic APIキー に置き換えてください。

Claude Desktopでの使用方法

このMCPサーバーをClaude Desktopで使用するには、Claude Desktopの設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "synthetic-web-search": {
      "command": "npx",
      "args": ["-y", "synthetic-web-search-mcp@latest"],
      "env": {
        "SYNTHETIC_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

設定を追加した後、Claude Desktopを再起動します。その後、会話でウェブ検索ツールを使用できます。

opencodeでの使用方法

このMCPサーバーをopencodeで使用するには、opencodeの設定に以下を追加します。

{
  "mcp": {
    "synthetic-web-search": {
      "type": "local",
      "command": ["npx", "-y", "synthetic-web-search-mcp@latest"],
      "environment": {
        "SYNTHETIC_API_KEY": "your_actual_api_key_here"
      },
      "enabled": true
    }
  }
}

your_actual_api_key_here を実際の Synthetic APIキー に置き換えてください。設定を追加した後、opencodeを再起動します。

MCPインスペクターでのテスト

Claude Desktopを使用せずにサーバーをテストするには、MCPインスペクターを使用します。

npx @modelcontextprotocol/inspector synthetic-web-search-mcp@latest

これにより、以下のことができるウェブインターフェースが開きます。

• 利用可能なツールを一覧表示する
• 異なるクエリで search_web ツールをテストする
• 返された結果をリアルタイムで表示する

✨ 主な機能

search_web

Synthetic APIを使用してウェブを検索します。

引数:

• query (文字列、必須): 検索クエリ文字列

例:

"TypeScript documentation" を検索する

戻り値: 検索結果のJSON配列で、各結果には以下が含まれます。

• url: 検索結果へのリンク
• title: ページのタイトル
• text: ページのスニペットまたは内容
• published: 公開日 (利用可能な場合)

📚 ドキュメント

API詳細

• エンドポイント: https://api.synthetic.new/v2/search
• メソッド: POST
• 認証: Authorization ヘッダーを介したベアラートークン
• リクエストボディ: query フィールドを含むJSON

プロジェクト構造

synthetic-web-search-mcp/
├── package.json
├── tsconfig.json
├── .env.example
├── README.md
├── src/
│   └── index.ts
└── dist/          (ビルド後に生成されます)
    ├── index.js
    └── index.d.ts

📄 ライセンス

MIT