# Native Mcp

> A suite of MCP (Model Context Protocol) servers packaged as a single static Go binary. Drop-in for Claude Code, Claude Desktop, Cursor, Cline, Zed and any MCP-aware client. No Node, no Python, no uv.

- **Type:** MCP server
- **Install:** `agentstack add mcp-kevinbonnoron-native-mcp`
- **Verified:** Pending review
- **Seller:** [KevinBonnoron](https://agentstack.voostack.com/s/kevinbonnoron)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [KevinBonnoron](https://github.com/KevinBonnoron)
- **Source:** https://github.com/KevinBonnoron/native-mcp
- **Website:** https://kevinbonnoron.github.io/native-mcp/

## Install

```sh
agentstack add mcp-kevinbonnoron-native-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# native-mcp

[](https://github.com/KevinBonnoron/native-mcp/actions/workflows/release.yml)
[](https://kevinbonnoron.github.io/native-mcp/)
[](https://github.com/KevinBonnoron/native-mcp/releases)
[](LICENSE)
[](https://go.dev)

> **One binary. Every MCP.** A suite of Model Context Protocol servers packaged as a single static Go binary — no Node, no Python, no `uv`. Drop-in for any MCP-aware client.

The official MCP ecosystem ships some servers as npm packages, others through `uvx`/PyPI. That fragmentation costs every consumer: slow startup, 30–60 MB per process, and two language runtimes to install just to run a handful of tools. `native-mcp` collapses the suite into one ~3 MB statically-linked binary that dispatches by subcommand and speaks strict JSON-RPC 2.0 over stdio.

```bash
native-mcp time
native-mcp filesystem /tmp /home/user/docs   # coming soon
native-mcp fetch                             # coming soon
```

Every subcommand is fully MCP-conformant, so the same binary plugs into Claude Code, Claude Desktop, Cursor, Continue, Cline, Zed, the official MCP Inspector — anything that speaks the protocol.

## Install

```bash
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/KevinBonnoron/native-mcp/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/KevinBonnoron/native-mcp/main/install.ps1 | iex
```

The installer downloads the right binary, verifies its SHA-256 checksum, and offers to register every bundled server in any MCP client it auto-detects. See the [install guide](https://kevinbonnoron.github.io/native-mcp/install) for flags and env vars.

## Servers

| Subcommand | Status | Tools |
| --- | --- | --- |
| [`time`](https://kevinbonnoron.github.io/native-mcp/servers/time) | ✅ shipped | `current_time`, `convert_time` |
| [`filesystem`](https://kevinbonnoron.github.io/native-mcp/servers/filesystem) | ✅ shipped | `read_file`, `write_file`, `list_directory`, `create_directory`, `move_file`, `delete_file`, `delete_directory`, `get_file_info`, `list_allowed_paths` |
| [`fetch`](https://kevinbonnoron.github.io/native-mcp/servers/fetch) | ✅ shipped | `fetch_url`, `list_allowed_domains` |
| [`calculator`](https://kevinbonnoron.github.io/native-mcp/servers/calculator) | ✅ shipped | `evaluate` |
| [`sqlite`](https://kevinbonnoron.github.io/native-mcp/servers/sqlite) | ✅ shipped | `query`, `execute`, `schema`, `list_tables` |
| [`shell`](https://kevinbonnoron.github.io/native-mcp/servers/shell) | ✅ shipped | `run`, `list_allowed_commands` (strict `--allow` allowlist, no shell expansion) |
| [`git`](https://kevinbonnoron.github.io/native-mcp/servers/git) | ✅ shipped | `status`, `log`, `diff`, `show`, `branch`, `add`, `commit` |
| [`json`](https://kevinbonnoron.github.io/native-mcp/servers/json) | ✅ shipped | `query`, `merge`, `validate` |
| [`crypto`](https://kevinbonnoron.github.io/native-mcp/servers/crypto) | ✅ shipped | `uuid`, `hash`, `random_bytes` |
| [`encode`](https://kevinbonnoron.github.io/native-mcp/servers/encode) | ✅ shipped | `base64_*`, `base32_*`, `hex_*`, `url_*` (encode/decode) |
| [`text`](https://kevinbonnoron.github.io/native-mcp/servers/text) | ✅ shipped | `slug`, `regex_match`, `regex_replace`, `diff`, `markdown_extract`, `html_extract` |
| [`system`](https://kevinbonnoron.github.io/native-mcp/servers/system) | ✅ shipped | `info`, `network_interfaces`, `meminfo`, `disk_usage`, `uptime`, `env` |
| [`dns`](https://kevinbonnoron.github.io/native-mcp/servers/dns) | ✅ shipped | `lookup` (A/AAAA/MX/TXT/CNAME/NS/PTR) |
| [`archive`](https://kevinbonnoron.github.io/native-mcp/servers/archive) | ✅ shipped | `create_zip`, `extract_zip`, `create_tar`, `extract_tar`, `list_allowed_paths` |
| [`scheduler`](https://kevinbonnoron.github.io/native-mcp/servers/scheduler) | ✅ shipped | `validate`, `next_run`, `previous_run` |
| [`clipboard`](https://kevinbonnoron.github.io/native-mcp/servers/clipboard) | ✅ shipped | `read`, `write` |

Each server defines its own permissions via CLI flags (e.g. `native-mcp filesystem /tmp /home/user/docs` is a sandbox of those two paths). No implicit access, no surprises.

## Documentation

Full docs at ****:

- [Install](https://kevinbonnoron.github.io/native-mcp/install) — one-liner, env vars, manual download, build from source
- [Server reference](https://kevinbonnoron.github.io/native-mcp/servers/time) — flags, tool schemas, examples per server
- [Use with Claude Code](https://kevinbonnoron.github.io/native-mcp/guides/claude-code) / [Claude Desktop](https://kevinbonnoron.github.io/native-mcp/guides/claude-desktop) / [Cursor](https://kevinbonnoron.github.io/native-mcp/guides/cursor) / [any MCP client](https://kevinbonnoron.github.io/native-mcp/guides/generic)
- [Debug with MCP Inspector](https://kevinbonnoron.github.io/native-mcp/guides/inspector)

## Develop

The repo ships a [Nix flake](flake.nix) that provisions Go, the LSP/linter/debugger toolchain, Node 20 (for the docs), and a few utilities. Everything lives in the dev shell — nothing leaks into your global env.

If you use [direnv](https://direnv.net/), the [.envrc](.envrc) takes care of it:

```bash
direnv allow
```

Without direnv, drop into the shell manually:

```bash
nix develop
```

Either way, you get:

```text
go              # 1.22+
gopls           # LSP
gotools         # goimports, etc.
go-tools        # staticcheck
golangci-lint   # linting
delve           # debugger
gofumpt         # stricter gofmt
nodejs_20       # for the VitePress docs
git
```

`GOPATH` and `GOCACHE` are pinned inside the repo (`.gocache/`, `.gopath/`, gitignored) so the dev shell doesn't pollute `~/go`.

### Common tasks

```bash
# Build the binary
go build -o native-mcp ./cmd/native-mcp

# Run all tests
go test ./...

# Smoke-test the time server end-to-end
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | ./native-mcp time

# Live-reload docs at http://localhost:5173/native-mcp/
cd docs && npm install && npm run dev
```

### Release flow

Pushing to `main` triggers [.github/workflows/release.yml](.github/workflows/release.yml): tests run, then a matrix builds binaries for `linux/{amd64,arm64}`, `darwin/{amd64,arm64}`, `windows/amd64`, generates `checksums.txt`, and rolls the `latest` GitHub release. The installer's `releases/latest/download/...` URLs point at the most recent build automatically.

Pushing to `main` with changes under [docs/](docs/) also triggers [.github/workflows/docs.yml](.github/workflows/docs.yml), which builds and deploys the VitePress site to GitHub Pages.

## License

[MIT](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [KevinBonnoron](https://github.com/KevinBonnoron)
- **Source:** [KevinBonnoron/native-mcp](https://github.com/KevinBonnoron/native-mcp)
- **License:** MIT
- **Homepage:** https://kevinbonnoron.github.io/native-mcp/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kevinbonnoron-native-mcp
- Seller: https://agentstack.voostack.com/s/kevinbonnoron
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.