@doublehitgames/gdd-mcp 0.4.1

package/README.md

@@ -0,0 +1,66 @@
+# @doublehitgames/gdd-mcp
+
+MCP server for [GDD Manager](https://gdd-app.vercel.app) — lets Claude (and other MCP-compatible AI assistants) read and write your game design documents.
+
+This is the **stdio** transport, meant for local clients like **Claude Desktop** and **Claude Code**. It runs on your machine and talks to the GDD Manager REST API using a personal API key.
+
+> **Prefer zero-setup?** If you use **claude.ai** or **Claude Desktop**, you can connect via the remote server with OAuth instead — no install, no key. Add a custom connector pointing to `https://gdd-app.vercel.app/api/mcp` and authorize with your account. Use this npm package only when you specifically want the local/stdio route (e.g. Claude Code, scripts, or working without a browser login).
+
+## Requirements
+
+- Node.js 18+
+- A GDD Manager API key (`gdd_sk_...`) — generate one at <https://gdd-app.vercel.app/settings/api-keys>
+
+## Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "gdd-manager": {
+      "command": "npx",
+      "args": ["-y", "@doublehitgames/gdd-mcp"],
+      "env": {
+        "GDD_API_KEY": "gdd_sk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. In a new chat, try: *"List my GDD projects"*.
+
+## Claude Code
+
+```bash
+claude mcp add gdd-manager -e GDD_API_KEY=gdd_sk_your_key_here -- npx -y @doublehitgames/gdd-mcp
+```
+
+## Configuration
+
+| Variable | Required | Default | Description |
+| --- | --- | --- | --- |
+| `GDD_API_KEY` | yes | — | Your personal API key (`gdd_sk_...`). |
+| `GDD_API_URL` | no | `https://gdd-app.vercel.app` | Base URL of the GDD Manager API (override for self-hosting). |
+
+## What it exposes
+
+- **Projects, sections, and addons** — full CRUD (list, read, create, update, delete).
+- **Typed addon tools** for each addon type (currency, inventory, economy link, progression table, production, data schema, attributes, and more), so the assistant fills the right fields.
+- **Search** across your projects and sections.
+- **Prompts** — ready-made flows like listing projects, viewing a project, and analyzing a GDD.
+
+The key scopes access to your own projects — the assistant only sees what your account can see.
+
+## Links
+
+- GDD Manager: <https://gdd-app.vercel.app>
+- Manage API keys: <https://gdd-app.vercel.app/settings/api-keys>
+
+## License
+
+MIT

package/dist/addon-tools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type-specific MCP tools for each addon type.
+ *
+ * 12 types × 2 (create + update) = 24 tools.
+ * Each tool fixes the addon `type` and provides a typed schema for `data`,
+ * then delegates to the generic addon API endpoint.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { GddApiClient } from "./client.js";
+export declare function registerAddonTools(server: McpServer, client: GddApiClient): void;