Latex Mathml MCP Server

🚀 LaTeX to MathML MCP Server

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

🚀 Quick Start

This server is designed to convert LaTeX mathematical expressions to MathML format. It provides a convenient way to perform such conversions through a standard MCP protocol.

✨ Features

• Convert LaTeX mathematical expressions to MathML.
• Offer two methods: tool conversion and resource access.
• Implement 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

After the server starts, it will listen for MCP client connections via stdio transmission.

Available Services

1. Tool 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 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

This project is licensed under the MIT license.