DeepMyst MCP服务器
*Claude桌面和HTTP客户端的智能LLM优化和路由*
概述
DeepMyst MCP服务器通过模型上下文协议（MCP）在DeepMyst和Claude Desktop或任何客户端之间创建无缝桥梁。这种集成使Claude和其他客户能够利用DeepMyst强大的优化和路由功能，同时保持您熟悉的工作流程。
主要特点
- 令牌优化 -在保持响应质量的同时，将代币使用量减少75%，直接降低API成本
- 智能模型路由 -根据任务要求自动为每个特定查询选择最佳LLM
- 组合能力 -同时使用优化和路由以获得最大效率
- 多种运输支持 -通过STDIO（适用于Claude Desktop）或SSE（适用于HTTP客户端）连接
- 客户提供的API密钥 -无需在服务器上存储DeepMyst API密钥
运作原理
- 令牌优化DeepMyst识别提示中的冗余，智能压缩内容，保留关键信息，并保持上下文意义——同时在不牺牲质量的情况下显著减少令牌使用。
- 智能路由：系统分析每个查询的类别、复杂性级别和所需功能。它通过加权评分系统根据性能基准、令牌成本、响应延迟和能力支持来评估可用模型。
安装
先决条件
- Python 3.8或更高版本
- UV-快速Python包安装程序
- Claude Desktop-最新版本（或其他MCP客户端）
- DeepMyst API密钥（从 platform.depmyst.com)
安装步骤
- 克隆或下载DeepMyst MCP服务器代码：
# Create a directory for the server
mkdir DeepMyst-MCP
cd DeepMyst-MCP
# Download the server code
# (Or copy the code from the provided deepmyst_mcp.py file)- 使用UV安装依赖项：
# Create and activate a virtual environment (optional but recommended)
uv venv
source .venv/bin/activate # On macOS/Linux
# OR
.venv\Scripts\activate # On Windows
# Install dependencies
uv pip install mcp openai aiohttp uvicorn starlette运行服务器
本地部署
对于Claude Desktop（STDIO传输）：
python deepmyst_mcp.py --stdio
# OR
uv run deepmyst_mcp.py --stdio对于HTTP客户端（SSE传输）：
python deepmyst_mcp.py --sse
# OR with custom host and port
python deepmyst_mcp.py --sse --host 127.0.0.1 --port 3000服务器现在支持显式命令行参数：
--stdio-使用STDIO传输运行（适用于Claude Desktop）--sse-使用SSE传输运行（适用于HTTP客户端）--host HOST-指定主机地址（默认值：0.0.0.0）--port PORT-指定端口号（默认值：8000）--debug-启用调试日志记录
您还可以使用环境变量：
export HOST=127.0.0.1 # Change the host
export PORT=3000 # Change the port
python deepmyst_mcp.py --sse公用服务器
DeepMyst MCP服务器可在以下网址公开获取：https://mcp.deepmyst.com
可用端点：
- SSE 端点 ：
https://mcp.deepmyst.com/sse - 消息端点：
https://mcp.deepmyst.com/messages
配置Claude桌面
- 打开您的Claude Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 添加DeepMyst MCP服务器配置：
{
"mcpServers": {
"deepmyst": {
"command": "python",
"args": [
"/path/to/deepmyst_mcp.py",
"--stdio"
]
}
}
}- 保存文件并重新启动Claude Desktop
工具和功能
DeepMyst MCP服务器提供了几个强大的工具：
- 获取最佳查询模型\
分析您的查询并推荐最佳模型。
Prompt: What's the best model for writing a poem about quantum physics?
Parameters:
- api_key: your-deepmyst-api-key- 优化完成\
通过令牌优化生成响应以降低成本。
Prompt: Use optimized_completion to explain quantum entanglement, with these parameters:
- api_key: your-deepmyst-api-key
- model: gpt-4o
- temperature: 0.7- 自动路由完成\
使用DeepMyst路由器生成响应以选择最佳模型。
Prompt: Use auto_routed_completion to generate a Python function with these parameters:
- api_key: your-deepmyst-api-key
- base_model: gpt-4o-mini- 智能完成\
结合路由和优化-首先确定查询的最佳模型，然后可选择应用令牌优化。
Prompt: Use smart_completion to explain how blockchain works, with these parameters:
- api_key: your-deepmyst-api-key
- optimize: true- DeepMyst完成\
最灵活的工具，所有选项均可配置。
Prompt: Use deepmyst_completion to summarize this article, with these parameters:
- api_key: your-deepmyst-api-key
- base_model: gpt-4o
- optimize: true
- auto_route: false高级用例
协作式多LLM问题解决
DeepMyst能够将复杂的问题分解并分布在多个专门的LLM中：
- 并行处理：将复杂任务划分为不同LLM可以同时解决的子任务
- 专家集成：将问题的不同方面分配给具有特定优势的模型（例如，GPT-4o用于创造性写作，Claude用于逻辑推理，Gemini用于数学分析）
- 建立共识：将同一问题路由到多个模型，并综合它们的答案以获得更可靠的答案
- 思维链增强：使用一个模型生成推理路径，然后让另一个模型验证或改进它
示例对于复杂的商业战略分析，DeepMyst可以将市场研究导向以数据为中心的模型，将创造性思维导向生成专家，将风险评估导向具有更好推理能力的模型。
处理大型上下文窗口
高效管理和处理大型文档或复杂对话：
- 上下文分块：将大型文档分解为可管理的部分，将每个部分路由到适当的模型，然后综合结果
- 渐进式总结：使用具有较小上下文窗口的模型来总结部分，然后将这些摘要提供给具有更广泛上下文功能的模型
- 优先级筛选：智能地识别和保存最相关的上下文，同时压缩不太重要的信息
- 上下文管理：通过动态压缩较旧的回合，在不超过令牌限制的情况下有效地维护对话历史记录
示例在分析一份500页的法律文件时，DeepMyst可以对文件进行分组，将部分内容路由到专门的法律分析模型，并逐步构建一个全面的分析，而不会触及上下文限制。
智能任务路由
根据任务的特定能力将其与最合适的模型相匹配：
- 能力匹配：自动识别任务要求，并将其与在这些领域表现出色的模型相匹配
- 成本优化：将简单查询路由到高效、低成本的模型，同时为复杂任务保留高级模型
- 延迟管理：根据时间敏感应用程序的响应时间要求选择型号
- 专业化路线：将特定领域的问题直接指向这些领域中性能最佳的模型
示例：财务分析工作流可以将数据处理路由到快速、高效的模型，将数值分析路由到数学专用模型，并将最终报告生成路由到具有更好写作能力的模型。
Web与SSE传输的集成
借助SSE传输支持，您可以将DeepMyst MCP集成到web应用程序中：
- 远程访问：通过HTTP从任何客户端访问您的DeepMyst MCP服务器
- Web应用程序：与web前端和后端集成
- 多个客户端：将多个客户端同时连接到同一服务器
- API网关：用作您自己应用程序的网关
示例：构建一个连接到DeepMyst MCP服务器的web界面，允许用户通过统一的UI与多个LLM进行交互。
支持的LLM提供商
DeepMyst支持多个LLM提供商，包括：
- OpenAI：GPT-4o、GPT-4o-mini等。
- Anthropic：克劳德3.7十四行诗、克劳德3.5十四行歌等。
- 谷歌：Gemini 2.0 Flash、Gemini 1.5 Pro等。
- 希腊：Calma 3.1、Mixtral等。
安全考虑
API密钥处理
服务器现在要求客户端在每次工具调用时提供DeepMyst API密钥。这有几个安全问题：
- 优势:
- 服务器上未存储API密钥 - 每个用户都可以使用自己的API密钥 - 服务器操作员不需要访问API密钥
- 注意事项:
- API密钥将在会话历史记录中可见 - 每次工具调用时都会传递密钥 - 如果配置不正确，可能会出现在日志中
为了增强生产环境中的安全性：
- 始终使用HTTPS进行服务器通信
- 考虑实施基于令牌的身份验证系统
- 在日志中实现密钥屏蔽
- 根据部署平台使用特定于环境的安全措施
资源
- 注册: platform.depmyst.com -创建DeepMyst帐户并获取您的API密钥
- 尝试DeepMyst: ask.deepmyst.com -互动演示，体验DeepMyst的功能
- 文档: docs.deepmyst.com -全面的指南和API文档
- 公共MCP服务器: mcp.deepmyst.com -使用公共DeepMyst MCP服务器
故障排除
常见问题
克劳德没有显示锤子图标：
- 确保Claude Desktop是最新的
- 检查配置文件是否存在语法错误
- 重新启动克劳德桌面
API关键错误：
- 验证您的DeepMyst API密钥是否正确
- 确保为每个工具调用提供API密钥
- 检查API关键参数名称中是否存在打字错误
服务器连接问题：
- 检查是否安装了所有依赖项
- 验证deepmyst_mcp.py的路径是否正确
- 在运行服务器的终端中查找错误消息
SSE运输问题：
- 检查该端口是否未被其他应用程序使用
- 验证客户端和服务器之间的网络连接
- 查找可能阻止连接的防火墙或网络限制
MCP检查器连接：
- 使用正确的格式进行连接：
npx @modelcontextprotocol/inspector dev http://localhost:8000 - 避免使用
--env可能导致解析问题的参数
日志
有关更详细的故障排除信息，请查看DeepMyst MCP服务器日志。日志被写入 deepmyst.log 与服务器脚本位于同一目录中。
您可以使用启用调试日志记录 --debug 标志：
python deepmyst_mcp.py --stdio --debug健康检查
对于SSE部署，您可以通过访问 deepmyst://health 资源：
Prompt: Check the health status of the DeepMyst MCP server.使用公共服务器
要连接到公共DeepMyst MCP服务器：
对于Web客户端
使用SSE端点连接到公共服务器：
const mcpClient = new McpClient({
sseEndpoint: "https://mcp.deepmyst.com/sse",
messageEndpoint: "https://mcp.deepmyst.com/messages"
});对于命令行客户端
将MCP CLI与SSE传输一起使用：
mcp connect sse --url https://mcp.deepmyst.com使用MCP检查器
要将MCP检查器连接到公共服务器，请执行以下操作：
npx @modelcontextprotocol/inspector dev https://mcp.deepmyst.com______________________________________________________________________
*DeepMyst MCP服务器根据MIT许可证获得许可*