Synthetic Web Search MCP

🚀 合成網絡搜索MCP服務器

這是一個模型上下文協議（MCP）服務器，它將合成網絡搜索API作為工具公開，供Claude和其他支持MCP的應用程序使用。

🚀 快速開始

使用Claude Code快速開始

使用以下單個命令將MCP服務器添加到Claude Code中：

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中使用

要在Claude Desktop中使用此MCP服務器，請將以下內容添加到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中使用

要在opencode中使用此MCP服務器，請將以下內容添加到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

這將打開一個Web界面，你可以在其中：

• 列出可用工具
• 使用不同的查詢測試 search_web 工具
• 即時查看返回的結果

✨ 主要特性

此服務器提供了一個 search_web 工具，允許MCP客戶端使用 Synthetic API 進行網絡搜索。搜索結果將以格式化的JSON形式返回，其中包含URL、標題、文本和發佈日期字段。

💻 使用示例

可用工具 - search_web

使用Synthetic API進行網絡搜索。

參數：

• query（字符串，必需）：搜索查詢字符串

示例：

搜索 "TypeScript文檔"

返回值： 一個包含搜索結果的JSON數組，每個結果包含：

• url：搜索結果的鏈接
• title：頁面標題
• text：頁面的摘要或內容
• published：發佈日期（如果可用）

📚 詳細文檔

API詳情

• 端點：https://api.synthetic.new/v2/search
• 方法：POST
• 身份驗證：通過 Authorization 標頭使用Bearer令牌
• 請求體：包含 query 字段的JSON

項目結構

synthetic-web-search-mcp/
├── package.json
├── tsconfig.json
├── .env.example
├── README.md
├── src/
│   └── index.ts
└── dist/          (生成於構建後)
    ├── index.js
    └── index.d.ts

📄 許可證

MIT