困惑度搜索MCP（或：基于困惑度的搜索MCP）
这个工具封装了搜索功能 困惑度人工智能（或译为“复杂度人工智能”，但“困惑度”在AI领域更常用） 转化为一个标准化工具，使用 模型上下文协议（MCP）它允许您执行带有过滤和自定义选项的高级搜索查询。
这个项目是用TypeScript构建的，并在……上运行 面包（或“馒头”，根据上下文，“Bun”在日语中常指馒头，但在其他语境下也可泛指面包） 运行时。
✨ 特点/功能
- 提供
perplexity-search通过MCP（多协议控制器）使用工具。 - 支持各种用于困惑度搜索的参数：
- query单个搜索查询或多查询搜索的查询数组。 - max_results指定要返回的搜索结果的最大数量（最多20个）。 - country根据地理位置（例如“美国”、“英国”、“德国”）过滤搜索结果。 - max_tokens_per_page在搜索处理过程中，控制从每个网页提取的最大标记数。较高的值可以提供更全面的内容提取，但可能会增加处理时间。 - search_domain_filter一个用于限制搜索结果的域名/URL列表。例如： ["science.org", "pnas.org", "cell.com"]
- 通过标准输入/输出（Stdio）与主机环境进行通信。
🚀 开始使用
1. 先决条件
- 确保你有 面包 已安装。
- 从Perplexity AI获取API密钥。
2. 安装
克隆项目后，在项目根目录下运行以下命令以安装所需的依赖项：
bun install3. 配置
设置 PERPLEXITY_API_KEY 使用包含您Perplexity API密钥的环境变量。
4. 运行服务器（开发环境）
要直接从TypeScript源代码运行服务器以进行开发，请执行以下命令：
bun run index.ts服务器将启动并监听标准输入输出上的MCP消息。
5. 构建项目
你可以将项目构建为一个单一的、经过优化的JavaScript文件：
bun run build这个可以编译 index.ts 并将输出放置在 dist/perplexity-search-mcp.js。
构建完成后，您可以直接运行编译后的文件：
bun dist/perplexity-search-mcp.js或者
node dist/perplexity-search-mcp.js🛠️ 工具定义
perplexity-search
描述从Perplexity持续更新的索引中检索排序后的搜索结果，并提供高级过滤和自定义选项。
输入参数：
| 参数 | 类型 | 描述 | 默认值 |
|---|---|---|---|
query | string 或者 string[] | 要执行的搜索查询或查询列表。可以是单个查询或多查询搜索的查询列表。 | 必填 |
max_results | number 返回搜索结果的最大数量（必须为不大于20的正整数）。 | 10 | |
country | string | 通过地理区域过滤搜索结果的国家代码（例如，'US'、'GB'、'DE'）。 | 可选 |
max_tokens_per_page | number | 从每个网页提取的最大标记数。较高的值会带来更全面的内容提取，但也可能增加处理时间。 | 2048 |
search_domain_filter | string[] 一个可选的域名/URL列表，用于限制搜索结果的范围（例如。， ["science.org", "pnas.org", "cell.com"])。 | 可选 |
输出：
该工具返回一个包含来自Perplexity API的搜索结果数组的JSON字符串。