DeepMyst MCP Server

DeepMyst MCP Server

面向 Claude Desktop 和 HTTP 客户端的智能大模型优化与路由

概述

DeepMyst MCP Server 通过 Model Context Protocol（MCP），在 DeepMyst 与 Claude Desktop 或任何客户端之间建立无缝桥梁。此集成让 Claude 和其他客户端能够利用 DeepMyst 强大的优化和路由能力，同时保留您熟悉的工作流。

主要功能

• Token 优化 - 在保持响应质量的同时，最多可减少 75% 的 token 用量，直接降低您的 API 成本
• 智能模型路由 - 根据任务要求，自动为每个具体查询选择最优大模型
• 能力组合 - 同时使用优化和路由，最大限度地提升效率
• 支持多种传输方式 - 通过 STDIO（用于 Claude Desktop）或 SSE（用于 HTTP 客户端）连接
• 客户端提供 API 密钥 - 无需在服务端存储您的 DeepMyst API 密钥

工作原理

• Token 优化：DeepMyst 会识别提示词中的冗余内容，智能压缩内容，同时保留关键信息并维持上下文含义，大幅减少 token 用量且不牺牲质量。

• 智能路由：系统会分析每个查询的类别、复杂度以及所需能力。它通过加权评分系统，根据性能基准、token 成本、响应延迟和能力支持情况评估可用大模型。

安装

先决条件

• Python 3.8 或更高版本
• UV - 快速 Python 软件包安装程序
• Claude Desktop - 最新版本（或其他 MCP 客户端）
• DeepMyst API 密钥（可从 platform.deepmyst.com 获取）

安装步骤

1. 克隆或下载 DeepMyst MCP Server 代码：

# 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)

2. 使用 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 Server 已公开提供，地址为：https://mcp.deepmyst.com

可用端点：

• SSE 端点：https://mcp.deepmyst.com/sse
• 消息端点：https://mcp.deepmyst.com/messages

配置 Claude Desktop

1. 打开 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 添加 DeepMyst MCP 服务配置：

{
  "mcpServers": {
    "deepmyst": {
      "command": "python",
      "args": [
        "/path/to/deepmyst_mcp.py",
        "--stdio"
      ]
    }
  }
}

3. 保存文件并重启 Claude Desktop

工具与能力

DeepMyst MCP 服务提供多种强大的工具：

1. 获取查询的最佳大模型
   分析您的查询并推荐最优大模型。

   Prompt: What's the best model for writing a poem about quantum physics?
   
   Parameters:
   - api_key: your-deepmyst-api-key
   

2. 优化补全
   生成经过 token 优化的响应，以降低成本。

   Prompt: Use optimized_completion to explain quantum entanglement, with these parameters:
   - api_key: your-deepmyst-api-key
   - model: gpt-4o
   - temperature: 0.7
   

3. 自动路由补全
   使用 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
   

4. 智能补全
   结合路由与优化——先确定最适合您查询的大模型，然后按需应用 token 优化。

   Prompt: Use smart_completion to explain how blockchain works, with these parameters:
   - api_key: your-deepmyst-api-key
   - optimize: true
   

5. 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
   

高级用例

协作式多大模型问题求解

DeepMyst 可将复杂问题拆解，并分配给多个专用大模型处理：

• 并行处理：将复杂任务拆分为子任务，由不同大模型同时解决
• 专家集成：将问题的不同方面分配给各有所长的模型（例如，GPT-4o 擅长创意写作，Claude 擅长逻辑推理，Gemini 擅长数学分析）
• 构建共识：将同一个问题发送给多个模型，并综合其回答，以获得更可靠的答案
• 增强思维链：使用一个模型生成推理路径，再让另一个模型进行验证或改进

示例：对于复杂的商业战略分析，DeepMyst 可以将市场调研发送给以数据处理见长的模型，将创意构思发送给生成领域的专家模型，并将风险评估发送给推理能力更强的模型。

处理大型上下文窗口

高效管理和处理大型文档或复杂对话：

• 上下文分块：将大型文档拆分为易于处理的片段，分别发送给合适的模型，然后综合结果
• 渐进式摘要：使用上下文窗口较小的模型总结各个部分，再将这些摘要提供给上下文处理能力更强的模型
• 优先级筛选：智能识别并保留最相关的上下文，同时压缩不太重要的信息
• 上下文管理：动态压缩较早的对话轮次，在不超出令牌限制的情况下有效保留对话历史

示例：分析一份 500 页的法律文件时，DeepMyst 可以将文件分块，将各部分发送给专门的法律分析模型，并逐步形成全面的分析结果，同时避免超出上下文限制。

智能任务路由

根据模型的具体能力，将任务匹配给最合适的模型：

• 能力匹配：自动识别任务需求，并匹配在相关领域表现出色的模型
• 成本优化：将简单查询路由给高效、成本较低的模型，同时将高端模型留给复杂任务
• 延迟管理：根据时效性应用的响应时间要求选择模型
• 专业化路由：将特定领域的问题发送给在相关领域表现最佳的模型

示例：金融分析工作流可以将数据处理路由给快速、高效的模型，将数值分析路由给专门处理数学问题的模型，并将最终报告生成路由给写作能力更强的模型。

使用 SSE 传输进行 Web 集成

借助 SSE 传输支持，你可以将 DeepMyst MCP 集成到 Web 应用中：

• 远程访问：通过 HTTP 从任何客户端访问 DeepMyst MCP 服务
• Web 应用：与 Web 前端和后端集成
• 多个客户端：让多个客户端同时连接到同一服务
• API 网关：用作自有应用的网关

示例：构建一个连接到 DeepMyst MCP 服务的 Web 界面，让用户通过统一的 UI 与多个大模型交互。

支持的大模型提供商

DeepMyst 支持多个大模型提供商，包括：

• OpenAI：GPT-4o、GPT-4o-mini 等。
• Anthropic：Claude 3.7 Sonnet、Claude 3.5 Sonnet 等。
• Google：Gemini 2.0 Flash、Gemini 1.5 Pro 等。
• Groq：Llama 3.1、Mixtral 等。

安全注意事项

API 密钥处理

现在，服务器要求客户端在每次工具调用时提供其 DeepMyst API 密钥。这会带来以下安全影响：

• 优点：

  • 服务器上不存储 API 密钥
  • 每位用户都可以使用自己的 API 密钥
  • 服务器运营者无需访问 API 密钥

• 注意事项：

  • API 密钥会显示在对话历史记录中
  • 每次工具调用都会传递密钥
  • 如果配置不当，密钥可能会出现在日志中

为增强生产环境中的安全性：

1. 始终使用 HTTPS 进行服务器通信
2. 考虑实施基于令牌的身份验证系统
3. 在日志中对密钥进行屏蔽
4. 根据部署平台采取适合该环境的安全措施

资源

• 注册：platform.deepmyst.com - 创建 DeepMyst 账户并获取 API 密钥
• 试用 DeepMyst：ask.deepmyst.com - 通过交互式演示体验 DeepMyst 的功能
• 文档：docs.deepmyst.com - 全面的指南和 API 文档
• 公共 MCP 服务：mcp.deepmyst.com - 使用 DeepMyst 公共 MCP 服务

故障排除

常见问题

Claude 未显示锤子图标：

• 确保 Claude Desktop 已更新至最新版本
• 检查配置文件是否存在语法错误
• 重启 Claude Desktop

API 密钥错误：

• 确认 DeepMyst API 密钥正确
• 确保每次工具调用都提供 API 密钥
• 检查 API 密钥参数名称是否有拼写错误

服务器连接问题：

• 检查是否已安装所有依赖项
• 确认 deepmyst_mcp.py 的路径正确
• 查看运行服务器的终端中是否有错误消息

SSE 传输问题：

• 检查端口是否被其他应用程序占用
• 确认客户端与服务器之间的网络连接正常
• 查看是否存在可能阻止连接的防火墙或网络限制

MCP Inspector 连接问题：

• 使用正确的连接格式：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"
});

对于命令行客户端

使用支持 SSE 传输的 MCP CLI：

mcp connect sse --url https://mcp.deepmyst.com

使用 MCP Inspector

若要将 MCP Inspector 连接到公共服务：

npx @modelcontextprotocol/inspector dev https://mcp.deepmyst.com

---

DeepMyst MCP 服务采用 MIT License 授权