Skip to content
eggstackPublic

About

A natural language math calculator with an MCP (Model Context Protocol) server for AI coding agents.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

eggsact

Crates.io Downloads License: MIT

A deterministic MCP server and Rust utility library for coding agents. It provides 86 tools across 23 categories, including math, text, JSON, validation, repository analysis, configuration, patches, and time. Tool cores use explicit inputs and do not access the network, clock, or filesystem.

Install

macOS and Linux:

curl --proto '=https' --tlsv1.2 -fsSL \
  https://github.com/eggstack/eggsact/releases/latest/download/install.sh | bash

Windows PowerShell:

irm https://github.com/eggstack/eggsact/releases/latest/download/install.ps1 | iex

Or install from source with Cargo. This requires Rust 1.89.0 or newer:

cargo install eggsact

See installation details for platform support, pinned versions, and inspect-first instructions.

Quick start

Use the calculator from your shell:

$ eggsact "thirty plus five"
35
$ eggsact "2 ** 10"
1024
$ eggsact "30m to ft"
98.42519685039369 ft

Natural-language math, functions, and unit conversions are supported. ^ is XOR, so use ** for powers. g means gram; use gravity for standard gravity. See CLI usage and math features.

Use with an MCP client

eggsact --mcp starts the stdio MCP server. The client launches and manages this process. The default direct surface lists tools allowed by the active profile and audience. discovery lists a smaller set of entry tools while keeping the same access rules.

eggsact --mcp
eggsact --mcp --mcp-surface discovery
eggsact integrate detect
eggsact integrate codex

eggsact integrate prints setup instructions and does not edit client configuration. It supports Zed, Codex, Claude, Cursor, VS Code, and OpenCode. See the MCP tool reference for tool behavior and installation for client setup.

Use from Rust

[dependencies]
eggsact = "1.2.7"
use eggsact::run;

let (answer, _kind) = run("thirty plus five").unwrap();
assert_eq!(answer, "35");

The Library API reference covers calculator functions, text utilities, typed preflight workflows, and in-process tool dispatch.

Documentation

eggsact is a Rust implementation of the Python eggcalc MCP server with a larger tool catalog. Its parity report lists 39 accepted test cases, represented by 40 ignored test instances, separately from regressions.

License

MIT. See LICENSE.

About

A natural language math calculator with an MCP (Model Context Protocol) server for AI coding agents.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages