validate_mermaid_syntax
Validate Mermaid diagram syntax by testing conversion to ensure code correctness before rendering images.
Instructions
通过尝试简单转换来验证 Mermaid 图表语法。
参数:
mermaid_code: 要验证的 Mermaid 图表语法代码
返回:
包含验证结果的字典Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mermaid_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- mermaid_mcp_server/main.py:218-290 (handler)Implements the validate_mermaid_syntax tool by cleaning the mermaid code, base64 encoding it, and performing a HEAD request to mermaid.ink/svg/ endpoint to check if the syntax is valid based on HTTP status.
@mcp.tool() def validate_mermaid_syntax(mermaid_code: str) -> Dict[str, Any]: """ 通过尝试简单转换来验证 Mermaid 图表语法。 参数: mermaid_code: 要验证的 Mermaid 图表语法代码 返回: 包含验证结果的字典 """ try: if not mermaid_code or not mermaid_code.strip(): return { "valid": False, "error": "Mermaid 代码是必需的，不能为空" } # 清理代码 cleaned_code = mermaid_code.replace("```mermaid", "").replace("```", "").strip() # 尝试编码 try: encoded_diagram = base64.urlsafe_b64encode(cleaned_code.encode('utf-8')).decode('ascii') except Exception as e: return { "valid": False, "error": f"编码图表失败：{str(e)}" } # 使用 SVG 格式进行快速验证 url = f"https://mermaid.ink/svg/{encoded_diagram}" try: response = requests.head(url, timeout=10) if response.status_code == 200: return { "valid": True, "message": "Mermaid 语法有效" } elif response.status_code == 400: return { "valid": False, "error": "无效的 Mermaid 语法" } else: return { "valid": False, "error": f"验证失败：HTTP {response.status_code}" } except requests.Timeout: return { "valid": False, "error": "验证超时" } except requests.ConnectionError: return { "valid": False, "error": "连接错误：无法访问验证服务" } except Exception as e: return { "valid": False, "error": f"验证错误：{str(e)}" } except Exception as e: return { "valid": False, "error": f"验证过程中发生意外错误：{str(e)}" } - mermaid_mcp_server/main.py:218-218 (registration)Registers the validate_mermaid_syntax function as an MCP tool using the FastMCP decorator.
@mcp.tool()