How it works
Real sockets, real wire formats. NetGet handles the bytes, the handler writes the content.
What you can build
HTTP mock API
"HTTP on 3000. GET /users returns fake JSON, POST /login always succeeds."
Test frontends without a backend.
Dummy database
"MySQL server. Answer any SELECT with realistic data."
No schema, no seed scripts.
Honeypot
"SSH on 2222. Act like Ubuntu, accept any password, log everything."
Watch attackers talk to an LLM.
Instant infra
"DNS on 5353. Resolve *.local to 127.0.0.1."
DNS, NTP, DHCP. One sentence each.
Protocols
Every protocol is a Cargo feature. Build with exactly what you need:
--features tcp,http,dns
transporttcp udp tftp socket_file datalink arp icmp igmp
webhttp http2 http3 tls proxy http_proxy socks5 openapi rss
naming & timedns dot doh mdns dhcp bootp ntp whois
remote accessssh ssh-agent telnet vnc
mail & newssmtp imap pop3 nntp
chat & voiceirc xmpp sip webrtc stun turn
queuesmqtt amqp kafka sqs zookeeper
databasesmysql postgresql mssql sqlite redis mongodb couchdb cassandra elasticsearch dynamodb etcd
files & storageftp s3 nfs smb webdav ipp
authoauth2 openid openidconnect saml-idp saml-sp ldap
rpcgrpc jsonrpc xmlrpc mcp
vpn & tunnelswireguard openvpn ipsec tor
routingbgp ospf isis rip
vcs & packagesgit mercurial svn npm pypi maven
p2pbitcoin torrent-tracker torrent-dht torrent-peer
hardwareusb usb-keyboard usb-mouse usb-serial usb-fido2 usb-smartcard bluetooth-ble nfc
observabilitysnmp syslog
llm backendsollama openai embedded-llm
Most protocols run as server and client. Maturity varies, see the README for status.
Install
MCP server for LLM agents (STDIO)
Add to claude_desktop_config.json or any MCP client config:
{
"mcpServers": {
"netget": {
"command": "npx",
"args": ["-y", "@smotana/netget", "--mcp"]
}
}
}
Claude Code: claude mcp add netget -- npx -y @smotana/netget --mcp
CLI
# install
npm install -g @smotana/netget # or grab a binary from GitHub Releases
# run with local Ollama
ollama pull qwen3-coder:30b
netget
# or run against any OpenAI-compatible API
netget --openai-url https://api.openai.com --model gpt-4o --api-key $OPENAI_API_KEY
From source
git clone https://github.com/smotanacom/netget.git
cd netget
# build only the protocols you need
cargo build --release --no-default-features --features tcp,http,ssh,dns,mcp-stdio
./target/release/netget # interactive TUI
./target/release/netget --mcp # MCP STDIO server