![\"Moonshine\"](\"docs/logo.png\"){kind=logo}
\n\n \n
\n Let AI assistants tap into your knowledge graph.\n
\n\n\n 한국어\n
\n\n---\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that connects AI assistants — Claude, ChatGPT, Gemini, and others — directly to your [Moonshine](https://github.com/Cognito-Distillery/moonshine) knowledge graph.\n\nIt reads the SQLite database file directly, so **Moonshine does not need to be running**.\n\n---\n\n## Prerequisites\n\n- **[Node.js](https://nodejs.org/) v20+**\n- **[Moonshine](https://github.com/Cognito-Distillery/moonshine)** installed with at least one mash created\n- *(Optional)* An API key from **OpenAI** or **Google Gemini** — only needed for `search_semantic`\n\n---\n\n## Setup\n\n### Claude Desktop\n\nAdd to your Claude Desktop config:\n\n| Platform | Config Path |\n|----------|-------------|\n| **Linux** | `~/.config/Claude/claude_desktop_config.json` |\n| **macOS** | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| **Windows** | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n\n```json\n{\n \"mcpServers\": {\n \"moonshine\": {\n \"command\": \"npx\",\n \"args\": [\"@cognito-distillery/moonshine-mcp\"]\n }\n }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add moonshine -- npx @cognito-distillery/moonshine-mcp\n```\n\n### Other MCP Clients\n\nAny MCP-compatible client can connect via **stdio transport**:\n\n```bash\nnpx @cognito-distillery/moonshine-mcp\n```\n\n---\n\n## Database Path\n\nThe server automatically finds your Moonshine database:\n\n| Platform | Default Path |\n|----------|------|\n| **Linux** | `~/.local/share/com.moonshine.app/moonshine.db` |\n| **macOS** | `~/Library/Application Support/com.moonshine.app/moonshine.db` |\n| **Windows** | `C:\\Users\\{user}\\AppData\\Roaming\\com.moonshine.app\\moonshine.db` |\n\nOverride with the `MOONSHINE_DB_PATH` environment variable if needed:\n\n```json\n{\n \"mcpServers\": {\n \"moonshine\": {\n \"command\": \"npx\",\n \"args\": [\"@cognito-distillery/moonshine-mcp\"],\n \"env\": {\n \"MOONSHINE_DB_PATH\": \"/custom/path/to/moonshine.db\"\n }\n }\n }\n}\n```\n\n---\n\n## Tools\n\n### Mash CRUD\n\n| Tool | Description |\n|------|-------------|\n| `list_mashes` | List mashes with optional filtering by status and type |\n| `get_mash` | Get a single mash by ID |\n| `create_mash` | Create a new mash (starts as MASH_TUN) |\n| `update_mash` | Partially update a mash's type, summary, context, or memo |\n| `delete_mash` | Delete a mash and its associated edges |\n\n### Search\n\n| Tool | Description |\n|------|-------------|\n| `search_keyword` | Full-text keyword search using FTS5 trigram tokenizer (Korean-friendly) |\n| `search_semantic` | Semantic similarity search using embeddings (requires API key in Moonshine settings) |\n\n### Knowledge Graph\n\n| Tool | Description |\n|------|-------------|\n| `get_graph` | Get the full graph of JARRED mashes with optional filtering by type, relation, or source |\n| `get_node_detail` | Get a node with its neighbors and connecting edges |\n| `add_edge` | Add or upsert a relationship between two mashes |\n| `update_edge` | Update an edge's relation type or confidence |\n| `delete_edge` | Delete an edge |\n\n### Stats\n\n| Tool | Description |\n|------|-------------|\n| `get_stats` | Get mash counts by status/type and total edge count |\n\n---\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `MOONSHINE_DB_PATH` | Override database file path | Auto-detected per platform |\n| `MOONSHINE_READ_ONLY` | Set to `true` to block all write operations | `false` |\n| `MOONSHINE_DEBUG` | Set to `true` for verbose stderr logging | `false` |\n\n---\n\n## Verifying\n\nRun the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) to test tools interactively:\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n---\n\n## Security\n\n- `password_hash` and `session_token` are **never exposed** through any tool\n- API keys are read from the settings table internally but **never returned** in tool responses\n- Use `MOONSHINE_READ_ONLY=true` to prevent any database writes\n- WAL mode enables safe concurrent reads alongside the running Moonshine app\n\n---\n\n## License\n\n[MIT](LICENSE)\n\n---\n\nunder the moonlight, in silence.
\n","readmeFilename":"README.md","_rev":"1-3fadf5ee98ae032f88e5b2d55f259fa1"}