{"_id":"nocturnusai-mcp","_rev":"3-73858aebe8823af008e51aeb2a912cd3","name":"nocturnusai-mcp","dist-tags":{"latest":"0.3.13"},"versions":{"0.3.11":{"name":"nocturnusai-mcp","version":"0.3.11","keywords":["nocturnusai","mcp","model-context-protocol","logic","inference","memory","reasoning","agent"],"license":"BUSL-1.1","_id":"nocturnusai-mcp@0.3.11","maintainers":[{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"}],"homepage":"https://nocturnus.ai/","bugs":{"url":"https://github.com/Auctalis/nocturnusai/issues"},"bin":{"nocturnusai-mcp":"dist/index.js"},"dist":{"shasum":"567e724329d762c2d95df6ccd6c2a629520a8c54","tarball":"https://registry.npmjs.org/nocturnusai-mcp/-/nocturnusai-mcp-0.3.11.tgz","fileCount":7,"integrity":"sha512-69EQgjrc09pJ2xaqD7tDwL5A19kYvIiz3onD1pIRUdfLmLzeufB5Zli7apW8pqrnpcwDgp0oZm1cLOQziQmavg==","signatures":[{"sig":"MEYCIQCaT+ee3CcBL9XEQU5KFCiZeyg+p7xRXRWzLXnLEKAMQgIhAK9Lxe4DmZWCpUGzw3yKy3jtuvEwe/h54xING9OrDhGp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19583},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"505b446a8bbb5ba6dd225e9de7bb7af5e8036fc8","mcpName":"ai.nocturnus/logic-server","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"},"repository":{"url":"git+https://github.com/Auctalis/nocturnusai.git","type":"git","directory":"sdks/mcp-server"},"_npmVersion":"10.9.2","description":"MCP stdio server for NocturnusAI — agent reasoning, memory lifecycle, and token-optimized context windows for AI applications.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/nocturnusai-mcp_0.3.11_1776304162095_0.2574669341926057","host":"s3://npm-registry-packages-npm-production"}},"0.3.12":{"name":"nocturnusai-mcp","version":"0.3.12","keywords":["nocturnusai","mcp","model-context-protocol","logic","inference","memory","reasoning","agent"],"license":"BUSL-1.1","_id":"nocturnusai-mcp@0.3.12","maintainers":[{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"}],"homepage":"https://nocturnus.ai/","bugs":{"url":"https://github.com/Auctalis/nocturnusai/issues"},"bin":{"nocturnusai-mcp":"dist/index.js"},"dist":{"shasum":"743f979af4c2c1ca932b3de2054be7deadbc8c5f","tarball":"https://registry.npmjs.org/nocturnusai-mcp/-/nocturnusai-mcp-0.3.12.tgz","fileCount":7,"integrity":"sha512-zQ9yTBQ6TL7RQnSjUdMWMjZhafiMPnukdc1YOTMRyYqfnkLvR59QRlL5G5hzlT1JsaOLwUWwsrFH9nrgqnC3fQ==","signatures":[{"sig":"MEUCIFSikcyO2JSSCyTqQvFvY4/qlffCMqdFr1Qa0M8HbSjrAiEAhJlvMP1kLh9yx+ZdrCwvPlOPqKQgwsKxjeHLYsP2MtQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61151},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"04c513186d55e3f5e688ec37ce634a082411af22","mcpName":"ai.nocturnus/logic-server","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"},"repository":{"url":"git+https://github.com/Auctalis/nocturnusai.git","type":"git","directory":"sdks/mcp-server"},"_npmVersion":"10.8.2","description":"MCP stdio server for NocturnusAI — agent reasoning, memory lifecycle, and token-optimized context windows for AI applications.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/nocturnusai-mcp_0.3.12_1776374915145_0.2725151761764597","host":"s3://npm-registry-packages-npm-production"}},"0.3.13":{"name":"nocturnusai-mcp","version":"0.3.13","description":"MCP stdio server for NocturnusAI — agent reasoning, memory lifecycle, and token-optimized context windows for AI applications.","type":"module","main":"dist/index.js","bin":{"nocturnusai-mcp":"dist/index.js"},"mcpName":"ai.nocturnus/logic-server","scripts":{"build":"tsc","prepublishOnly":"tsc","start":"node dist/index.js","dev":"tsc --watch"},"keywords":["nocturnusai","mcp","model-context-protocol","logic","inference","memory","reasoning","agent"],"license":"BUSL-1.1","repository":{"type":"git","url":"git+https://github.com/Auctalis/nocturnusai.git","directory":"sdks/mcp-server"},"homepage":"https://nocturnus.ai/","bugs":{"url":"https://github.com/Auctalis/nocturnusai/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.3.0"},"engines":{"node":">=18.0.0"},"_id":"nocturnusai-mcp@0.3.13","gitHead":"6f9209d043a5ac8310e378247005d23ed5bc8de9","types":"./dist/index.d.ts","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-rBPYhtqRwq50anTpr0sH22IXxwUwQ5r7z3W/t+6X0FBWP3UrrOxO8oaTLS2OyXKuDD5eviMe0EFk2SVAV5AzOQ==","shasum":"043c6667505278975e602db186e277e9dd55a92f","tarball":"https://registry.npmjs.org/nocturnusai-mcp/-/nocturnusai-mcp-0.3.13.tgz","fileCount":7,"unpackedSize":68174,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCxoNzIfswVgEC1iW96fnV8MBLKkSn8xQt6tZ+mMDf4xAIgckFlCc2UeSCgYoUyNX95eE3XnydwAQQ5U9inFH2lz68="}]},"_npmUser":{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"},"directories":{},"maintainers":[{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nocturnusai-mcp_0.3.13_1776434446134_0.44580253449374374"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-16T01:49:21.959Z","modified":"2026-04-17T14:00:46.404Z","0.3.11":"2026-04-16T01:49:22.227Z","0.3.12":"2026-04-16T21:28:35.286Z","0.3.13":"2026-04-17T14:00:46.294Z"},"bugs":{"url":"https://github.com/Auctalis/nocturnusai/issues"},"license":"BUSL-1.1","homepage":"https://nocturnus.ai/","keywords":["nocturnusai","mcp","model-context-protocol","logic","inference","memory","reasoning","agent"],"repository":{"type":"git","url":"git+https://github.com/Auctalis/nocturnusai.git","directory":"sdks/mcp-server"},"description":"MCP stdio server for NocturnusAI — agent reasoning, memory lifecycle, and token-optimized context windows for AI applications.","maintainers":[{"name":"auctalis-npm","email":"parkway-pack-29@icloud.com"}],"readme":"# nocturnusai-mcp\n\n[![nocturnusai MCP server](https://glama.ai/mcp/servers/Auctalis/nocturnusai/badges/score.svg)](https://glama.ai/mcp/servers/Auctalis/nocturnusai)\n\nMCP stdio server for [NocturnusAI](https://nocturnus.ai/) — agent reasoning, memory, and token-optimized context for AI applications. Point any MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.) at a running NocturnusAI instance and get:\n\n- **Deterministic reasoning** — multi-step inference with proof chains, not LLM guessing\n- **Token-optimized context** — salience-ranked retrieval puts only the most relevant facts in your context window, cutting token waste\n- **Agent memory lifecycle** — temporal facts, auto-expiration, consolidation, and decay so long-running agents stay focused\n- **Truth maintenance** — automatic retraction of derived knowledge when premises change\n\nThis package is a thin stdio shim. It forwards MCP requests to a NocturnusAI server's `/mcp` JSON-RPC endpoint. It does not include the server itself.\n\n## Quick start — run a NocturnusAI server\n\nThe fastest way to get a server running locally:\n\n```bash\ndocker run -d --name nocturnusai -p 9300:9300 ghcr.io/auctalis/nocturnusai:latest\n```\n\nData persists to a named Docker volume. Point your MCP client at this instance via the config below.\n\nAlternatives: build from source (`./gradlew :nocturnusai-server:run` from [the repo](https://github.com/Auctalis/nocturnusai)) or deploy to your own infra.\n\n## Client configuration\n\n### Claude Desktop (`claude_desktop_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"nocturnusai\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"nocturnusai-mcp\"],\n      \"env\": {\n        \"NOCTURNUSAI_URL\": \"http://localhost:9300\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf\n\nSame structure — most clients accept a `command` + `args` + `env` block.\n\n## Environment variables\n\n| Variable              | Default                  | Purpose                                           |\n| --------------------- | ------------------------ | ------------------------------------------------- |\n| `NOCTURNUSAI_URL`     | `http://localhost:9300`  | Base URL of the NocturnusAI server                |\n| `NOCTURNUSAI_API_KEY` | _(none)_                 | Sent as `X-API-Key` when set                      |\n| `NOCTURNUSAI_DATABASE`| `default`                | Sent as `X-Database` header                       |\n| `NOCTURNUSAI_TENANT`  | `default`                | Sent as `X-Tenant-ID` header                      |\n\n## What tools are available\n\nWhatever tools the upstream NocturnusAI server exposes. As of 0.3.x this includes `tell`, `ask`, `teach`, `forget`, `predicates`, `context`, `aggregate`, `bulk_assert`, `retract_pattern`, `fork_scope`, `merge_scope`, `list_scopes`, `delete_scope`. The shim is transparent — new tools added to the server appear automatically without a package update.\n\n## Design\n\n- `tools/list` and `tools/call` requests are forwarded via HTTP JSON-RPC 2.0 to `${NOCTURNUSAI_URL}/mcp`.\n- Tool schemas come from the upstream server. This package doesn't duplicate them.\n- Startup prints a warning to stderr if `/health` is unreachable so misconfig fails loudly.\n\n## License\n\nBUSL-1.1\n","readmeFilename":"README.md"}