LaTeX to MathML MCP Server

LaTeX 转 MathML MCP 服务

一个可将 LaTeX 数学表达式转换为 MathML 格式的模型上下文协议（MCP）服务。本 README.md 由 DeepSeek V3 编写。

功能

• 将 LaTeX 数学表达式转换为 MathML
• 同时提供基于工具的转换和基于资源的访问
• 实现标准 MCP 协议，便于集成
• 使用 MathJax-node 实现轻量、快速的转换

安装

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install mathjax-node
   npm install @modelcontextprotocol/sdk
   

使用方法

启动服务

使用 Node.js 运行服务：

node index.js

服务将启动，并通过 stdio 传输监听 MCP 客户端连接。

可用服务

1. 基于工具的转换：

   • 工具名称：latex2mathml
   • 输入：LaTeX 字符串
   • 输出：MathML 字符串

2. 基于资源的访问：

   • 资源 URI 模式：mathml://{latex_expression}
   • 返回：LaTeX 表达式的 MathML 表示

客户端集成

要从 MCP 客户端连接到此服务，请将以下配置添加到客户端的设置中：

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

将 path_to_your_server/index.js 替换为服务脚本的实际路径。

API 详情

工具：latex2mathml

请求格式：

{
    "latex": "your_LaTeX_expression"
}

请求示例：

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

响应格式：

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

资源：mathml://{id}

使用以下 URI 模式将数学表达式作为资源访问：

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

（注意：资源 URI 中的 LaTeX 表达式应进行 URL 编码）

开发

依赖项

• @modelcontextprotocol/sdk：MCP 服务 SDK
• mathjax-node：LaTeX 转 MathML
• zod：输入验证

构建

这是一个 Node.js 项目。只需按照“安装”部分中的说明克隆仓库并安装依赖项即可。

许可证

MIT