Persistent AI memory using orbital mechanics. 100% local, zero API keys, MCP-native.
Connect Runs on your machine
claude mcp add stellar-memory -e STELLAR_PROJECT=<STELLAR_PROJECT> -e STELLAR_DB_PATH=<STELLAR_DB_PATH> -e STELLAR_API_PORT=<STELLAR_API_PORT> -e STELLAR_SUN_TOKEN_BUDGET=<STELLAR_SUN_TOKEN_BUDGET> -- npx -y [email protected]
{
"mcpServers": {
"stellar-memory": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"STELLAR_PROJECT": "<STELLAR_PROJECT>",
"STELLAR_DB_PATH": "<STELLAR_DB_PATH>",
"STELLAR_API_PORT": "<STELLAR_API_PORT>",
"STELLAR_SUN_TOKEN_BUDGET": "<STELLAR_SUN_TOKEN_BUDGET>"
}
}
}
}
{
"mcpServers": {
"stellar-memory": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"STELLAR_PROJECT": "<STELLAR_PROJECT>",
"STELLAR_DB_PATH": "<STELLAR_DB_PATH>",
"STELLAR_API_PORT": "<STELLAR_API_PORT>",
"STELLAR_SUN_TOKEN_BUDGET": "<STELLAR_SUN_TOKEN_BUDGET>"
}
}
}
}
{
"servers": {
"stellar-memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"STELLAR_PROJECT": "<STELLAR_PROJECT>",
"STELLAR_DB_PATH": "<STELLAR_DB_PATH>",
"STELLAR_API_PORT": "<STELLAR_API_PORT>",
"STELLAR_SUN_TOKEN_BUDGET": "<STELLAR_SUN_TOKEN_BUDGET>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
STELLAR_PROJECTOptional | Active project name for memory isolation |
STELLAR_DB_PATHOptional | Path to SQLite database file (default: ~/.stellar-memory/stellar.db) |
STELLAR_API_PORTOptional | REST API port (default: 21547) |
STELLAR_SUN_TOKEN_BUDGETOptional | Max tokens for Sun context (default: 800) |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 12 Mar 2026 |
| Last updated | 12 Mar 2026 |
| Registry name | io.github.sangjun0000/stellar-memory |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
