Mcp LogicBLOCK
Fully functional AI Logic Calculator utilizing Prover9/Mace4 via Python based Model Context Protocol (MCP-Server)- tool for Windows, Linux, Claude App etc
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://github.com/angrysky56/mcp-logic/actions/workflows/ci.yml)
An MCP server for automated first-order logic reasoning using Prover9, Mace4, and an onboard reasoning LLM.
Features
- Theorem Proving - Prove logical statements with Prover9
- Model Finding - Find finite models with Mace4
- Counterexample Finding - Show why statements don't follow
- Syntax Validation - Pre-validate formulas with helpful error messages
- Categorical Reasoning - Built-in support for category theory proofs
- Propositional Contingency - Purely analytical HCC prover for fast propositional checks
- Abductive Reasoning - Rank hypotheses using Variational Free Energy (VFE)
- 🤖 Logic Advisor (NEW) - Onboard TwIL-LM3 reasoning LLM that solves logic problems end-to-end: just ask a question in plain English
- Self-Contained - All dependencies install automatically
Quick Start
Installation
Linux/macOS:
git clone https://github.com/angrysky56/mcp-logic cd mcp-logic ./linux-setup-script.sh
Windows:
git clone https://github.com/angrysky56/mcp-logic cd mcp-logic windows-setup-mcp-logic.bat
The setup script automatically:
- Downloads and builds LADR (Prover9 + Mace4)
- Creates Python virtual environment
- Installs all dependencies
- Generates Claude Desktop config
Enable the Logic Advisor (Optional)
The onboard logic advisor uses a local 3B-parameter LLM (TwIL-LM3 Q8) to solve logic problems end-to-end. Run the setup script to install it:
Linux/macOS:
./setup-advisor.sh
Windows:
setup-advisor.bat
The script automatically:
- Detects your GPU — CUDA on NVIDIA (Linux/Windows), Metal on Apple Silicon (macOS), or falls back to CPU
- Compiles `llama-cpp-python` with the right a
75879b3cf907OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add mcp_logic -- uvx mcp_logic
{
"mcpServers": {
"mcp_logic": {
"command": "uvx",
"args": [
"mcp_logic"
]
}
}
}Exposed tools (4)
4 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
check_contingency | read | Check if a classical propositional formula is truth-functionally contingent using HCC |
check_well_formed | read | Check if logical statements are well-formed |
get_category_axioms | read | Get FOL axioms for category theory (category, functor, group, etc.) |
verify_commutativity | read | Verify categorical diagram commutativity |
Trust audit
BLOCKgrade D · trust 60/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | WARN |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (2 observation(s))
- Network
- declared (4 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (14)
ENV DOCKER_HOST=unix:///var/run/docker.sock
sudo apt-get remove -y "${pkg}" || truesudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
sudo gpg --dearmor --yes --output /etc/apt/keyrings/docker.gpg "${DOCKER_GPG_KEY}"sudo systemctl start docker
sudo systemctl enable docker
system use found in code, not declared in the description
.hadolint.yaml
.isort.cfg
.markdownlint.yaml
.shellcheckrc
.yamllint.yaml
Gates applied: no_behavioural_pass.
75879b3cf907full audit observations/trust-audit/mcp-server/angrysky56__mcp-logic.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 75879b3cf907 | BLOCK | D | 60 | first audit |
Questions
What is the Mcp Logic MCP server?
Fully functional AI Logic Calculator utilizing Prover9/Mace4 via Python based Model Context Protocol (MCP-Server)- tool for Windows, Linux, Claude App etc
What tools does Mcp Logic expose?
4 in total: 4 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Mcp Logic safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (60/100) and found 6 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does Mcp Logic need?
No credential environment variables were found in its source, so it appears to need none.
How does Mcp Logic run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as mcp_logic.
How current is this page?
The grade is for one exact copy of the source (75879b3cf907), read on 2026-10-08. The repository is watched and re-audited when it changes.