使用说明
通过实时网络搜索、引用和人工智能推理来回答任何问题——所有这些都在一次通话中。
一个模型上下文协议(MCP)服务器,公开了困惑人工智能的API,用于实时网络搜索和引用来源的对话查询。
概述
困惑MCP服务器提供基于人工智能的网络搜索,并有可靠的引用支持:
- 查询实时网络,获取LLM综合答案和源引用
- 控制响应长度、温度和底层搜索模型
- 浏览可用的困惑模型,为每个任务选择合适的功能
非常适合:
- 让AI助手访问时事、新闻和实时信息
- 回答需要模型训练截止日期之外的最新事实的研究问题
- 通过引用、可验证的网络资源丰富人工智能工作流程
工具
health_check — Check server readiness
返回一个状态对象,确认服务器正在运行且可访问。
输入: (无)
输出:
{
"status": "ok",
"server": "CL Perplexity MCP Server"
}
search — Search the web with Perplexity AI
向Perplexity的在线搜索模型发送查询,并返回LLM生成的答案,其中包含来自实时网络资源的引用。
输入:
- `query` (string, required) — Search query to look up on the web
- `model` (string, optional) — Model to use (default: llama-3.1-sonar-small-128k-online)
- `max_tokens` (integer, optional) — Maximum tokens in the response, 1–4096
- `temperature` (float, optional) — Sampling temperature 0–2; higher = more creative (default: model default)
输出:
{
"success": true,
"query": "latest AI research papers 2025",
"response": "Recent AI research has focused on...",
"model": "llama-3.1-sonar-small-128k-online",
"usage": {
"prompt_tokens": 12,
"completion_tokens": 320,
"total_tokens": 332
}
}
get_models — List available Perplexity models
返回通过困惑API可用的所有模型,分为在线(网络搜索)和离线(非搜索)类别。
输入: (无)
输出:
{
"success": true,
"total_models": 6,
"online_models": [
"llama-3.1-sonar-small-128k-online",
"llama-3.1-sonar-large-128k-online",
"llama-3.1-sonar-huge-128k-online"
],
"other_models": [
"llama-3.1-sonar-small-128k-chat",
"llama-3.1-sonar-large-128k-chat"
],
"all_models": [...]
}
API参数参考
Model Selection
在线模特 (包括实时网络搜索):
llama-3.1-sonar-small-128k-online--快速、经济高效;网络搜索的默认值llama-3.1-sonar-large-128k-online--更高质量的答案,更彻底的搜索llama-3.1-sonar-huge-128k-online--质量最好,最全面;最高成本
使用 get_models 要检索当前的完整列表,会定期添加新模型。
Generation Parameters
temperature--控制随机性;0.0对于集中的事实答案,1.0+创意回应(范围:0-2)max_tokens--上限响应长度;可用于控制成本和延迟(范围:1–4096)
获取您的困惑API密钥
Steps
- 去 困惑API设置
- 登录或创建困惑帐户
- 在...之下 API密钥,单击 +生成
- 复制生成的密钥——安全存储,不会再次显示
困惑的API使用是根据模型和令牌计数按每个请求计费的。在线模型在网络搜索中会消耗额外的积分。
故障排除
Missing or Invalid Headers
- 原因: 请求头中未提供API密钥或格式不正确
- 解决方案:
- 验证
Authorization: Bearer YOUR_API_KEY和X-Mewcp-Credential-Id: CREDENTIAL-ID标题存在 - 检查您的MewCP帐户中的API密钥是否处于活动状态
- 验证
Insufficient Credits
- 原因: API调用已超出您的请求限制
- 解决方案:
- 在您的Curious Layer仪表板中检查信用使用情况
- 升级到付费计划或为更高的限额添加积分
- 联系支持部门进行信用调整
Credential Not Connected
- 原因: 没有与您的帐户链接的困惑凭证
- 解决方案:
- 首选 凭证 在您的MewCP仪表板中
- 添加您的困惑API密钥
- 使用正确的重试请求
X-Mewcp-Credential-Id头球
Malformed Request Payload
- 原因: JSON负载无效或缺少必填字段
- 解决方案:
- 发送前验证JSON语法
- 确保
query参数包含在内,并且是一个非空字符串 - 检查一下
temperature介于0.0和2.0之间,并且max_tokens介于1和4096之间
Server Not Found
- 原因: API终结点中的服务器名称不正确
- 解决方案:
- 验证端点格式:
{server-name}/mcp/{tool-name} - 使用文档中正确的服务器名称
- 检查您的Curious Layer帐户中的可用服务器
- 验证端点格式:
Perplexity API Error
- 原因: 上游困惑API返回错误
- 解决方案:
- 检查困惑服务状态 困惑状态页面
- 验证您的API密钥是否有足够的信用用于所选模型
- 查看错误消息以了解具体详细信息(例如,超过速率限制、型号ID无效)
