MQL5文档智能搜索服务

MCP Server MQL5是一个为MQL5开发设计的智能文档搜索服务,集成大型语言模型(LLMs)如Claude,提供对官方MQL5文档的高效访问,使通用AI模型成为专业的MQL5编码助手。

  • by jhontd03
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 jhontd03/mcp-server-mql5

使用说明

MCP服务器MQL5

一 MCP服务器 用于MQL5开发,旨在与Claude等大型语言模型(LLM)集成。它提供了对官员的智能访问 MQL5文档,允许通用AI模型成为专家MQL5编码助手。

特性

  • 📚 智能文档搜索:查询官方MQL5搜索API以查找最相关的文档页面。
  • 🧠 上下文感知提取:从MQL5.com中抓取和清理HTML内容,剥离不必要的元素(脚本、样式、导航),为LLM提供纯净、令牌高效的上下文。
  • ⚡ 高性能:实现智能缓存,以防止冗余网络请求并缩短响应时间。
  • 🛡️ 速率限制:内置速率限制器确保MQL5.com资源的礼貌使用,防止IP禁令。
  • 🔄 强大的网络:通过自动用户代理轮换和重试逻辑优雅地处理网络错误。

安装

我们建议使用 紫外线 用于依赖关系管理,但标准 pip 也得到了支持。

使用紫外线(推荐)

通过以下方式高效安装 uv:

# Clone the repository
git clone https://github.com/jhontd03/mcp-server-mql5.git
cd mcp-server-mql5

# Install dependencies
uv sync

使用pip

pip install .

配置

克劳德代码(CLI)

将此服务器添加到 克劳德代码,在终端中运行以下命令(替换 C:\path\to\mcp-server-mql5 使用您的实际绝对路径):

claude mcp add mql5 -- uv --directory "C:\path\to\mcp-server-mql5" run mcp-server-mql5

备注:在Windows上,确保使用存储库的绝对路径。

反重力

使用此服务器 反重力 或其他MCP客户端,将以下配置添加到您的 mcp_config.json:

{
  "mcpServers": {
    "mql5": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/path/to/mcp-server-mql5",
        "run",
        "mcp-server-mql5"
      ]
    }
  }
}

注:更换 C:/path/to/mcp-server-mql5 使用克隆存储库的实际绝对路径。

发展

该项目使用现代Python开发工具来确保代码质量。

设置

# Install dependencies including dev tools
uv sync

质量保证

我们使用 拉夫 (装订/格式化)和 MyPy 的 (静态类型检查)。

设置预提交挂钩:

这确保了检查在每次提交之前自动运行。

uv run pre-commit install

手动运行检查:

# Run all pre-commit hooks on all files
uv run pre-commit run --all-files

测试

使用以下命令运行测试套件 pytest:

uv run pytest

组件

  • server.py:主MCP服务器入口点。
  • core/scraper.py:基于BeautifulSoup的HTML提取器。
  • core/search.py:用于分析MQL5搜索API结果的逻辑。
  • core/web_client.py:异步HTTP客户端 aiohttp.
  • core/utils.py:速率限制器和日志记录实用程序。

许可证

根据MIT许可证分发。看 LICENSE 了解更多信息。