Latex Mathml MCP Server

🚀 LaTeX 到 MathML MCP 服務器

本項目是一個使用 Model Context Protocol (MCP) 的服務器，可將 LaTeX 數學表達式轉換為 MathML 格式，為數學表達式的處理提供了便捷的解決方案。此 README.md 文件由 DeepSeek V3 編寫。

🚀 快速開始

本服務器能將 LaTeX 數學表達式轉換為 MathML 格式，支持工具轉換和資源訪問兩種方式，且基於標準 MCP 協議實現，便於集成。下面為你介紹啟動服務器的步驟：

# 克隆此倉庫
git clone https://github.com/HappyAny/latex-mathml-mcp-server.git
cd latex-mathml-mcp-server

# 安裝依賴項
npm install mathjax-node
npm install @modelcontextprotocol/sdk

# 啟動服務器
node index.js

服務器啟動後將通過 stdio 傳輸監聽 MCP 客戶端連接。

✨ 主要特性

• 格式轉換：將 LaTeX 數學表達式轉換為 MathML。
• 兩種方式：提供工具轉換和資源訪問兩種方式。
• 便於集成：標準 MCP 協議實現，便於集成。
• 輕量快速：使用 MathJax - node 實現輕量級快速轉換。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install mathjax-node
npm install @modelcontextprotocol/sdk

💻 使用示例

啟動服務器

node index.js

可用服務

工具轉換

• 工具名稱：latex2mathml
• 輸入：LaTeX 字符串
• 輸出：MathML 字符串

資源訪問

• 資源 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

⚠️ 重要提示：LaTeX 表達式應在資源 URI 中進行 URL 編碼。

🔧 技術細節

依賴項

• @modelcontextprotocol/sdk：MCP 服務器 SDK
• mathjax-node：LaTeX 到 MathML 轉換
• zod：輸入驗證

構建

這是一個 Node.js 項目。只需克隆倉庫並按照安裝部分安裝依賴項即可。

📄 許可證

本項目採用 MIT 許可證。