MCP Server Tool for Searching Lean Mathlib 4 Docs in VSCode

Lean Mathlib Docs MCP

This is an MCP server designed for VSCode, specifically used for searching the documentation of Lean Mathlib 4. It allows users to query declarations, modules, and instances and obtain relevant documentation links and detailed information.

Developer tools Search tools #Documentation Search #Lean Mathematical Library #MCP Protocol #Local Processing .Python

rating : 2.5 points

downloads : 4.9K

update time : 2025-12-03

Open Site

What is the Lean Mathlib 4 Documentation Search MCP Server?

This is a documentation search tool specifically designed for the Lean mathematical library Mathlib 4. It allows developers and researchers to quickly search for documentation content such as mathematical theorems, function definitions, and module descriptions in the VSCode editor, and obtain detailed mathematical library documentation information without leaving the editor environment.

How to use the Lean Mathlib 4 Documentation Search MCP Server?

After installation and configuration, you can directly query the Mathlib 4 documentation in VSCode through specific commands. The system will automatically download and process the documentation data, and then provide fast and accurate search results.

Applicable Scenarios

Suitable for learners of the Lean programming language, researchers in mathematical formal verification, developers of the Mathlib 4 library, and any users who need to quickly refer to mathematical theorem and function documentation when writing Lean code.

Main Features

Intelligent Document Search

Supports searching Mathlib 4 documentation by declaration name, module name, instance, etc., providing accurate search results and document links.

MCP Protocol Integration

Implemented based on the Model Context Protocol standard, ensuring seamless integration with tools that support MCP. Currently, it mainly supports the VSCode editor.

Local Data Processing

Automatically downloads and processes Mathlib 4 documentation data to the local when running for the first time. Subsequent queries do not require an internet connection, and the response speed is fast.

VSCode Special Support

Optimized specifically for the VSCode editor, providing a smooth in - editor document query experience without switching applications.

Advantages

Seamlessly integrated into the VSCode workflow to improve coding efficiency

Local data processing ensures fast query response speed

Supports a rich variety of search types and query methods

Based on an open - source protocol, it can be freely used and modified

Limitations

Currently, it only supports the VSCode editor. Other editors need to wait for subsequent support

The documentation data needs to be downloaded when using it for the first time, which occupies a certain amount of storage space

Only supports Mathlib 4 documentation and does not include other Lean libraries

Requires a Python 3.11+ environment, which has certain requirements for the system

How to Use

Environment Preparation

Ensure that Python 3.11 or a higher version is installed on the system, and prepare the VSCode editor.

Clone the Project

Clone the project from the GitHub repository to the local directory.

Install Dependencies

Use conda to create a virtual environment and install all necessary Python dependency packages.

Configure MCP

Ensure that the mcp.json configuration file is correctly placed in the .vscode folder or the project root directory.

Start Using

Start VSCode, the MCP server will run automatically, and you can directly start querying the documentation.

Usage Examples

Find Theorems Related to Group Theory

When you are learning or writing Lean code related to group theory, you need to quickly find the definition, properties, or related theorems of groups.

Find the Usage of a Specific Function

When writing code and encountering an unfamiliar function, you need to view its parameter types, return values, and usage examples.

Explore the Structure of Mathematical Modules

You want to understand the module organization and available functions in a certain mathematical field in Mathlib 4.