使用说明
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 了解更多信息。