story-vault-mcp

# story-vault-mcp MCP server for **Story Vault** — a local-first writing app. This server lets any MCP-compatible AI client (Claude Desktop, Cursor, Cline, Qwen Chat, …) read and write your encrypted Story Vault project data: scenes, characters, world notes, ideas, the main story/manuscript, and project memory. This is the Python distribution (`uvx story-vault-mcp`). The server itself is a Node.js program; this package embeds it and launches it for you. **Node.js >= 18 is required on PATH.** ## Install / run ```sh uvx story-vault-mcp ``` Or install with pip: ```sh pip install story-vault-mcp story-vault-mcp ``` ## Configuration The server needs three environment variables (your vault PIN is used **only** to decrypt the database and is never exposed to the AI): | Variable | Required | Purpose | | --- | --- | --- | | `STORY_VAULT_PIN` | yes | Your vault PIN. | | `STORY_VAULT_DATA_DIR` | no | Path to the vault data dir (default `<cwd>/data`). | | `STORY_VAULT_PROJECT_ID` | no | Default project ID — tools can omit `project_id`. | ### Claude Desktop Edit `claude_desktop_config.json`: ```json { "mcpServers": { "story-vault": { "command": "uvx", "args": ["story-vault-mcp"], "env": { "STORY_VAULT_PIN": "your-pin", "STORY_VAULT_PROJECT_ID": "1", "STORY_VAULT_DATA_DIR": "C:/path/to/your/vault/data" } } } } ``` ### Other clients (Cursor, Cline, …) Use the same `command`/`args`/`env` shape in the client's MCP configuration. ## Tools 37 tools covering the full project surface — see the project's `ARCHITECTURE.md` ("MCP Server (External AI Access)" section) for the complete list. Highlights: - `list_projects` / `get_project` / `create_project` / `update_project` - `list_scenes` / `read_scene_content` / `create_scene` / `save_scene_version` (writes prose) - `list_characters` / `create_character` / `update_character` - `list_world_notes` / `create_world_note` - `list_ideas` / `create_idea` - `get_main_sto…