Latex MathML

🚀 LaTeX to MathML MCP Server

A server implemented using the Model Context Protocol (MCP) to convert LaTeX mathematical expressions into MathML format. This README.md file is written by DeepSeek V3.

🚀 Quick Start

The LaTeX to MathML MCP Server is designed to convert LaTeX mathematical expressions into MathML format. It offers two ways of conversion and is easy to integrate with other systems using the standard MCP protocol.

✨ Features

• Convert LaTeX mathematical expressions to MathML.
• Provide both tool-based conversion and resource access methods.
• Adopt the standard MCP protocol for easy integration.
• Use MathJax-node for lightweight and fast conversion.

📦 Installation

1. Clone this repository:

git clone https://github.com/HappyAny/latex-mathml-mcp-server.git
cd latex-mathml-mcp-server

2. Install dependencies:

npm install mathjax-node
npm install @modelcontextprotocol/sdk

💻 Usage Examples

Basic Usage

Start the Server

Run the server using Node.js:

node index.js

The server will start and listen for MCP client connections transmitted via stdio.

Available Services

1. Tool-based Conversion:

• Tool Name: latex2mathml
• Input: LaTeX string
• Output: MathML string

2. Resource Access:

• Resource URI Pattern: mathml://{latex_expression}
• Return: MathML representation of the LaTeX expression

Advanced Usage

Client Integration

To connect to this server from an MCP client, add the following configuration to the client settings:

{
    "mcpServers": {
        "latex-mathml-server": {
            "isActive": true,
            "command": "node",
            "args": [
                "path_to_your_server/index.js"
            ]
        }
    }
}

Replace path_to_your_server/index.js with the actual path to your server script.

📚 Documentation

API Details

Tool: latex2mathml

Request Format:

{
    "latex": "your_LaTeX_expression"
}

Example Request:

{
    "latex": "E = mc^2"
}

Response Format:

{
    "content": [
        {
            "type": "text",
            "text": "<math xmlns=\"http://www.w3.org/1998/Math/MathML\">...</math>"
        }
    ]
}

Resource: mathml://{id}

Access mathematical expressions via resources using the following URI pattern:

mathml://E%20%3D%20mc%5E2

(Note: The LaTeX expression should be URL-encoded in the resource URI)

🔧 Technical Details

Dependencies

• @modelcontextprotocol/sdk: MCP server SDK
• mathjax-node: LaTeX to MathML conversion
• zod: Input validation

Build

This is a Node.js project. Simply clone the repository and install the dependencies as described in the Installation section.

📄 License

MIT