symbolic_math_mcp
MCP server for symbolic math derivation, calculation, and verification
Documentation
symbolic_math_mcp

Symbolically verify any equation and calculation
Requirements
- Python 3.11+
- `fastmcp>=3.4.2`
- `symbolic-math-verify>=0.1.4`
Install
python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -e .Configuration
Default configuration file: config.json
{
"mcp_server_name": "My Symbolic Math MCP Server",
"mcp_server_url": "http://localhost:8753",
"max_requests": 10,
"total_timeout": 600
}Notes
- `stdio://...` runs the server over stdio.
- `http://...` runs the server over FastMCP's streamable HTTP transport.
- `https://...` is accepted by the config parser and uses the HTTP transport settings. In practice, TLS is typically terminated by a reverse proxy in front of the process.
Run
From the project directory:
.venv/bin/python run_server.py --config config.jsonOr after installation:
symbolic-math-mcp --config config.jsonTool API
`check_symbolic_math(filename)`
- input: absolute path to a `.yaml` symbolic math file
- behavior: blocks until `verify_yaml_file(filename)` completes or times out
Successful completion:
{
"status": "Tool call completed!",
"filename": "proof.yaml",
"result": "Math proofs are valid"
}Timeout:
{
"status": "Tool call has timed out!",
"filename": "proof.yaml",
"result": "TIMEOUT ERROR!"
}File not found:
{
"status": "Tool call cannot find the file based on the filename!",
"filename": "proof.yaml",
"result": "FILE NOT FOUND!"
}File read error:
{
"status": "Tool call cannot read the file!",
"filename": "proof.yaml",
"result": "FILE CANNOT BE READ!"
}Unknown error:
{
"status": "Tool call has unknown error!",
"filename": "proof.yaml",
"result": "UNKNOWN ERROR!"
}`check_symbolic_math_parallel(dir_path)`
- input: absolute directory path containing one or more `.yaml` symbolic math files
- behavior: starts verification for each `.yaml` file in parallel, bounded by `max_requests`, and blocks until all checks finish or the total timeout is exceeded
- result keys: absolute file paths for each `.yaml` file found in `dir_path`
- failure behavior: if `dir_path` is missing, not absolute, unreadable, or contains no `.yaml` files, the tool returns the same structured error shape used by `check_symbolic_math`
Successful completion:
{
"status": "Parallel Tool call completed!",
"dir_path": "/abs/path/to/proofs",
"result": {
"/abs/path/to/proofs/one.yaml": "Math proofs are valid",
"/abs/path/to/proofs/two.yaml": "Error! Math proofs are invalid"
}
}Timeout:
{
"status": "Tool call has timed out!",
"filename": "/abs/path/to/proofs",
"result": "TIMEOUT ERROR!"
}Directory not found or no YAML files:
{
"status": "Tool call cannot find the file based on the filename!",
"filename": "/abs/path/to/proofs",
"result": "FILE NOT FOUND!"
}Tests
The test suite is intentionally sequential.
Run all tests:
PYTHONPATH=src /home/brosnan/symbolic_math_mcp/.venv/bin/python tests/run_tests_sequentially.pyThe integration test starts a real stdio MCP server subprocess and validates:
- 5 valid YAML files in tests_yaml
- 5 invalid YAML files in tests_yaml
Codex Config
[mcp_servers.symbolic_math_mcp]
url = "http://localhost:8753/mcp"
[mcp_servers.symbolic_math_mcp.tools.check_symbolic_math]
approval_mode = "approve"
[mcp_servers.symbolic_math_mcp.tools.check_symbolic_math_parallel]
approval_mode = "approve"Frequently asked questions
What is symbolic_math_mcp?
symbolic_math_mcp is MCP server for symbolic math derivation, calculation, and verification
How do I install symbolic_math_mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is symbolic_math_mcp open source?
Yes — it is hosted on GitHub at https://github.com/BrosnanYuen/symbolic_math_mcp and has 1 stars.
Related MCP tools
Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace MCP Server & CLI Tool
Open source implementation and extension of Google Research’s PaperBanana for automated academic figures, diagrams, and research visuals, expanded to new domains like slide generation.
An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Python-based implementation. Trusted by 11000+ developers.
Build effective agents using Model Context Protocol and simple workflow patterns Python-based implementation. Trusted by 7600+ developers.
Cut AI token costs 95%+ on code exploration. The leading MCP server for precise, symbol-level GitHub code retrieval via tree-sitter AST. Works with Claude Code, Cursor & any MCP client. 313B+ tokens saved.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP