Dynoxide
A DynamoDB emulator with an MCP server exposing 35 DynamoDB tools to coding agents.
At a glance
Not tested yet- GitHub stars
- 112
- Weekly downloads
- 29,261
- Last commit
- 2026-11-19
- Licence
- Apache-2.0
- Transport
- stdio
- Auth
- none
npx -y dynoxide
What it does
Dynoxide is a DynamoDB emulator written in Rust and backed by SQLite. It runs as an HTTP server or an MCP server for coding agents, and it can also be embedded in Rust and iOS applications as a library. It is built for local development, testing and CI, not as a production DynamoDB replacement.
Key features
- Runs as an HTTP server or an MCP server for coding agents.
- Backed by SQLite and ships as a native binary.
- Implements the DynamoDB API across tables, items, query and scan, batches, transactions, PartiQL, streams, TTL and tags, with GSI and LSI support.
- Supports the full expression syntax, plus DynamoDB-compatible pagination, validation and error codes.
- Can be embedded in Rust and iOS applications as a library.
- Compiles to WebAssembly for the browser.
- Continuously verified against real DynamoDB by Parity Suite, the DynamoDB conformance suite.
Quick start
Run a local server without installing anything:
npx dynoxide --port 8000
Or install it into a project to pin the version:
npm install --save-dev dynoxide
Point any AWS SDK or DynamoDB client at http://localhost:8000.
Add it to Claude Code from a terminal:
claude mcp add dynoxide -- npx -y dynoxide
Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"dynoxide": {
"command": "npx",
"args": [
"-y",
"dynoxide"
]
}
}
}Environment variables
The registry entry declares no environment variables.
Example prompts
- Start a local Dynoxide server on port 8000 so I can point my DynamoDB client at it.
- Create a table in the local emulator and put a few items into it.
- Run a PartiQL query against the local emulator.
- Enable a stream on a table and read the stream records.
What to watch out for
- Dynoxide is built for local development, testing and CI. It is not a production DynamoDB replacement.
- Cloud-only operations have no local equivalent and return an
UnknownOperationException: backups and point-in-time restore, global tables, Kinesis streaming, resource policies and capacity management. ConsistentReadis accepted but changes nothing, because SQLite is strongly consistent. You cannot reproduce eventually-consistent reads.- Streams expose a single shard.
DescribeStreamreturns one shard, and itsExclusiveStartShardIdandLimitpaging parameters are accepted but ignored. - Transaction-contention errors (
TransactionConflictException,TransactionInProgressException) are not emulated, because there is no concurrent contention in a single process. - The WebAssembly build passes every test it implements but has a far higher skip count than any other target, because several operations are still missing.
Not tested by tools4agents yet. Read the source repository before you install it.
Similar tools
Everything
The official test server. Exercises every part of the protocol, so it is the fastest way to check your setup works at all.
Filesystem
Gives an agent scoped read and write access to directories you name explicitly. The usual first MCP server people install.
Git
Read, search, and manipulate local Git repositories. Lets an agent inspect history and diffs without shelling out.
Sequential Thinking
Gives a model a scratchpad for multi step reasoning, letting it revise earlier steps instead of committing to a first answer.