STARWARCLOUD STARWAR.AI
返回市场
深秘之核-MCP

深秘之核-MCP

作者：DeepMyst2 星标更新：2025-04-11
安装使用来源：spider==github.com

项目介绍

DeepMyst MCP Server

智能LLM优化与路由，适用于Claude桌面版和HTTP客户端

DeepMyst MCP

概述

DeepMyst MCP Server通过模型上下文协议（MCP）在DeepMyst和Claude桌面版或其他客户端之间创建无缝桥梁。这种集成允许Claude和其他客户端利用DeepMyst的强大优化和路由功能，同时保持熟悉的流程。

主要特性

  • 令牌优化 - 最多可减少75%的令牌使用量，同时保持响应质量，直接降低API成本
  • 智能模型路由 - 根据任务需求自动选择每个特定查询的最佳LLM
  • 组合能力 - 同时使用优化和路由以达到最大效率
  • 多种传输支持 - 通过STDIO（用于Claude桌面版）或SSE（用于HTTP客户端）连接
  • 客户端提供的API密钥 - 不需要在服务器上存储您的DeepMyst API密钥

工作原理

  • 令牌优化：DeepMyst识别提示中的冗余，智能压缩内容，保留关键信息，并保持上下文意义——所有这些都在显著减少令牌使用的同时不牺牲质量。

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

安装

先决条件

  • Python 3.8 或更高版本
  • UV - 快速Python包安装器
  • Claude桌面版 - 最新版本（或另一个MCP客户端）
  • DeepMyst API密钥（从platform.deepmyst.com获取）

安装步骤

  1. 克隆或下载DeepMyst MCP Server代码：
# 创建一个服务器目录
mkdir DeepMyst-MCP
cd DeepMyst-MCP

# 下载服务器代码
# （或者复制提供的deepmyst_mcp.py文件中的代码）
  1. 使用UV安装依赖项：
# 创建并激活虚拟环境（可选但推荐）
uv venv
source .venv/bin/activate  # 在macOS/Linux上
# 或者
.venv\Scripts\activate     # 在Windows上

# 安装依赖项
uv pip install mcp openai aiohttp uvicorn starlette

运行服务器

本地部署

对于Claude桌面版（STDIO传输）：

python deepmyst_mcp.py --stdio
# 或者
uv run deepmyst_mcp.py --stdio

对于HTTP客户端（SSE传输）：

python deepmyst_mcp.py --sse
# 或者自定义主机和端口
python deepmyst_mcp.py --sse --host 127.0.0.1 --port 3000

服务器现在支持明确的命令行参数：

  • --stdio - 使用STDIO传输（针对Claude桌面版）
  • --sse - 使用SSE传输（针对HTTP客户端）
  • --host HOST - 指定主机地址（默认：0.0.0.0）
  • --port PORT - 指定端口号（默认：8000）
  • --debug - 启用调试日志

您也可以使用环境变量：

export HOST=127.0.0.1  # 更改主机
export PORT=3000       # 更改端口
python deepmyst_mcp.py --sse

公共服务器

DeepMyst MCP Server公开可用地址为：https://mcp.deepmyst.com

可用端点：

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

配置Claude桌面版

  1. 打开您的Claude桌面配置文件：

    • 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"
      ]
    }
  }
}
  1. 保存文件并重启Claude桌面版

工具和能力

DeepMyst MCP服务器提供多个强大工具：

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

    提示：哪种模型最适合写一篇关于量子物理的诗歌？

参数：
- api_key: your-deepmyst-api-key

  2. 优化完成 生成带有令牌优化的响应以降低成本。

    提示：使用optimized_completion解释量子纠缠，参数如下：
- api_key: your-deepmyst-api-key
- model: gpt-4o
- temperature: 0.7

  3. 自动路由完成 使用DeepMyst路由器选择最佳模型生成响应。

    提示：使用auto_routed_completion生成Python函数，参数如下：
- api_key: your-deepmyst-api-key
- base_model: gpt-4o-mini

  4. 智能完成 结合路由和优化——首先确定查询的最佳模型，然后可选地应用令牌优化。

    提示：使用smart_completion解释区块链如何工作，参数如下：
- api_key: your-deepmyst-api-key
- optimize: true

  5. DeepMyst完成 最灵活的工具，所有选项均可配置。

    提示：使用deepmyst_completion总结这篇文章，参数如下：
- 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网关：作为您自己应用程序的网关使用

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

支持的LLM提供商

DeepMyst支持多个LLM提供商，包括：

  • 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. 根据您的部署平台使用特定的安全措施

资源

故障排除

常见问题

Claude没有显示锤子图标：

  • 确保Claude桌面版是最新的
  • 检查配置文件是否有语法错误
  • 重启Claude桌面版

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资源来检查服务器健康状态：

提示：检查DeepMyst MCP服务器的健康状况。

使用公共服务器

要连接到公共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 Inspector

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

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

DeepMyst MCP Server根据MIT许可证授权