oOo0oOo/lean-lsp-mcp

解决的问题

该项目在 LLM 代理与 Lean 定理证明器之间搭建了一座桥梁。它允许 AI 代理以编程方式与 Lean 项目交互，使它们能够分析代码、检查证明状态，并在无需人工手动在证明器和 LLM 之间复制粘贴信息的情况下，搜索相关的数学定理和定义。

工作原理

它实现了一个 Model Context Protocol (MCP) 服务器，通过 leanclient 库使用 Language Server Protocol (LSP) 与 Lean 通信。该服务器公开了一组工具，MCP 兼容代理（如 Claude Code、Cursor 或 VSCode）可以调用这些工具来执行以下操作：

• 检查 Lean 项目：访问诊断信息、目标状态、项信息和悬停文档。
• 搜索定理：使用 Loogle、Lean Search 和 Lean Hammer 等外部搜索工具查找现有的证明和定义。
• 运行代码：执行 Lean 代码片段，支持可选的快速 REPL 模式以加快迭代速度。
• 管理文件：在项目范围内读取和写入 Lean 文件。

适用人群

专为从事形式数学、自动形式化和自动定理证明的代理推理系统的研究人员和开发者设计。

特色亮点

• 丰富的工具集：包含目标状态检查、本地源码扫描（通过 ripgrep）、多种远程/本地搜索后端。
• LSP 集成：利用现有的 Lean Language Server 实现对项目的深度分析。
• 灵活的部署方式：支持 stdio、HTTP 流式传输和 SSE 多种传输方式，可运行在 Docker 容器中以获得更好的隔离性。
• 本地 Loogle 支持：支持运行本地 Loogle 搜索引擎实例，以绕过远程 API 的速率限制。