# 🤖 AI Search MCP Server

[![MCP](https://img.shields.io/badge/MCP-Protocol-blue)](https://modelcontextprotocol.io)
[![Python](https://img.shields.io/badge/Python-3.10%2B-green)](https://www.python.org)
[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Claude%20%7C%20Cursor%20%7C%20Cline%20%7C%20WorkBuddy-8A2BE2)]()

**智能搜索聚合 MCP 工具** — 输入任意搜索查询，自动识别意图，返回结构化结果 + 平台跳转链接。

适用场景：Agent 对话中用户说「想看 XX」「哪里买 XX」「想学 XX」等，直接调用本工具获取聚合结果。

---

## ✨ 效果演示

```
用户: 想看庆余年

Agent 调用 ai_search → 返回:

🎬 影视观看

📌 庆余年 第一季（电视剧）   孙皓（导演）   ⭐ 豆瓣7.9
   • 腾讯视频 | VIP ¥25/月 | 全网独播 → 📱 在App中打开

📌 庆余年 第二季（电视剧）   孙皓（导演）   ⭐ 豆瓣7.3
   • 腾讯视频 | VIP ¥25/月 → 📱 在App中打开

📌 庆余年 小说原著（小说）   猫腻   ⭐ 豆瓣8.9
   • 起点中文网 | 部分免费 → 📱 在App中打开
   • 微信读书 | 免费/无限卡

💡 第一季和第二季均已完结，可在腾讯视频观看。想了解详情可读原著。
```

---

## 🚀 快速开始

### 1. 安装

```bash
pip install mcp
git clone https://github.com/lzycjwds/-ai-search-mcp.git
cd ai-search-mcp
```

### 2. 获取 API Key（任选一个）

| 模型 | 注册地址 | 价格 | 推荐度 |
|------|----------|------|--------|
| **DeepSeek** | [platform.deepseek.com](https://platform.deepseek.com) | ¥1/百万 token | ⭐⭐⭐⭐⭐ |
| 通义千问 | [dashscope.aliyun.com](https://dashscope.aliyun.com) | 有免费额度 | ⭐⭐⭐⭐ |
| 智谱 GLM | [open.bigmodel.cn](https://open.bigmodel.cn) | 有免费额度 | ⭐⭐⭐⭐ |
| Moonshot | [platform.moonshot.cn](https://platform.moonshot.cn) | ¥12/百万 token | ⭐⭐⭐ |
| OpenAI | [platform.openai.com](https://platform.openai.com) | $2.5/百万 token | ⭐⭐⭐ |

### 3. 配置到你的 MCP 客户端

#### Claude Desktop

编辑配置文件（`设置 → 开发者 → 编辑配置`）：

```json
{
  "mcpServers": {
    "ai-search": {
      "command": "python",
      "args": ["/你的路径/ai-search-mcp/server.py"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-你的DeepSeek密钥"
      }
    }
  }
}
```

#### Cursor

编辑 `~/.cursor/mcp.json`，配置同上。

#### Cline (VS Code)

编辑 `~/.cline/mcp_settings.json`，配置同上。

#### WorkBuddy

编辑 `~/.workbuddy/mcp.json`，在 `mcpServers` 中追加，配置同上。

### 4. 重启客户端，开始使用

---

## 🛠 工具列表

### `ai_search`

通用搜索聚合，自动识别意图。

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `query` | string | ✅ | 搜索查询，如「想看庆余年」 |
| `provider` | string | ❌ | LLM 提供商，默认 `deepseek` |

**支持的搜索类型**：

| 意图 | 示例查询 | 返回内容 |
|------|----------|----------|
| 🎬 影视 | 想看庆余年 / 哪里看三体 | 平台、价格、季数、评分 |
| 📖 小说 | 三体小说在哪看 / 庆余年原著 | 阅读平台、是否免费、作者 |
| 🛒 商品 | 哪里买iPhone / RTX5090多少钱 | 各平台比价、促销信息 |
| 📚 课程 | 想学Python / 日语怎么学 | 平台、免费/付费、推荐 |
| 🎵 音乐 | 听周杰伦 / 播客推荐 | 平台、VIP、曲库 |
| 🍜 餐厅 | 上海本帮菜推荐 | 店名、人均、评分 |
| 🔍 信息 | 特斯拉市值 / XX是什么 | 数据、来源 |

### `ai_search_compare`

对比搜索，用于比较多个选项。

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `query` | string | ✅ | 对比查询，如「iPhone16 vs 华为Mate70」 |
| `provider` | string | ❌ | LLM 提供商，默认 `deepseek` |

---

## 🔑 环境变量

| 变量名 | 对应模型 |
|--------|----------|
| `DEEPSEEK_API_KEY` | DeepSeek |
| `OPENAI_API_KEY` | OpenAI |
| `ZHIPU_API_KEY` | 智谱 GLM |
| `MOONSHOT_API_KEY` | Moonshot |
| `DASHSCOPE_API_KEY` | 通义千问 |

---

## 📁 项目结构

```
ai-search-mcp/
├── server.py          # MCP Server 主程序
├── pyproject.toml     # Python 项目配置
├── README.md          # 本文件
├── LICENSE            # MIT 开源协议
└── .gitignore
```

---

## ❓ 常见问题

**Q: 为什么不用搜索 API（如 SerpAPI）？**
A: 为了零额外成本。DeepSeek 等大模型对热门内容的训练数据足以覆盖大部分搜索需求。如需实时信息，可在 `call_llm()` 前插入搜索 API 调用。

**Q: 支持哪些 App 跳转？**
A: 内置 70+ 主流平台的 URL Scheme，包括视频、阅读、电商、外卖、音乐、学习等。LLM 漏了链接也会自动补全。

**Q: 怎么切换模型？**
A: 调用时传 `provider` 参数，或在 MCP 配置中设置对应环境变量。

---

## 📄 License

MIT — 随意使用、修改、分发。