{"_id":"@ai_design_agency/sdd-mcp","_rev":"3-a7860b52722a9336c505291de4d49fed","name":"@ai_design_agency/sdd-mcp","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@ai_design_agency/sdd-mcp","version":"1.0.0","keywords":["sdd","mcp","model-context-protocol","claude","spec-driven-development","aida"],"author":{"name":"AIDA"},"license":"MIT","_id":"@ai_design_agency/sdd-mcp@1.0.0","maintainers":[{"name":"aida_joel","email":"joel@aida.agency"}],"homepage":"https://github.com/aida-ai/sdd-platform#readme","bugs":{"url":"https://github.com/aida-ai/sdd-platform/issues"},"bin":{"sdd-mcp":"dist/index.js"},"dist":{"shasum":"5dea3f71317948302b03c6e06a716d164473283e","tarball":"https://registry.npmjs.org/@ai_design_agency/sdd-mcp/-/sdd-mcp-1.0.0.tgz","fileCount":38,"integrity":"sha512-u6NTDleCxtan953mOmkSLZq7+Ai9Q/saUAyxGMt1ArhBTLqy3PPN3INKepXigHP2uYTxn0i6tJ9C9ziOk6OrEw==","signatures":[{"sig":"MEQCIEaSlB8Nbshx4UaQZBO6NN+XyeZD1EbOD7EtaaZs4qe/AiB5K6NGyQ/86KwHBv81gNTwwKi/2DqzeiGO6K9b2QmVwA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66619},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"39a7702447fcb39bd7dd6ea4384a0f1de0d05856","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","test:watch":"vitest","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"aida_joel","email":"joel@aida.agency"},"repository":{"url":"git+https://github.com/aida-ai/sdd-platform.git","type":"git","directory":"packages/sdd-mcp"},"_npmVersion":"10.9.3","description":"MCP server for SDD Platform - exposes spec, process, and session management as Claude tools","directories":{},"_nodeVersion":"22.18.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@ai_design_agency/sdd-core":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^2.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdd-mcp_1.0.0_1767261086564_0.8899359869412666","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@ai_design_agency/sdd-mcp","version":"1.2.0","keywords":["sdd","mcp","model-context-protocol","claude","spec-driven-development","aida"],"author":{"name":"AIDA"},"license":"MIT","_id":"@ai_design_agency/sdd-mcp@1.2.0","maintainers":[{"name":"aida_joel","email":"joel@aida.agency"}],"homepage":"https://github.com/aida-ai/sdd-platform#readme","bugs":{"url":"https://github.com/aida-ai/sdd-platform/issues"},"bin":{"sdd-mcp":"dist/index.js"},"dist":{"shasum":"08f3eb816a73683040b21b3408341eeb0fc46966","tarball":"https://registry.npmjs.org/@ai_design_agency/sdd-mcp/-/sdd-mcp-1.2.0.tgz","fileCount":38,"integrity":"sha512-h8bFwru8Vq5RbOv1tEuxCJCE/dKGhH1roIVwIv6YlmBtq7zi8ibvEhYtSleMZrkrcsG7jBATZ2198S+CxrMGsA==","signatures":[{"sig":"MEQCIHoczkrsQiz98uYuu2TD9lySEqsAqXXFXfApPRbF8p4SAiBHIWFkXDGE5vlTJUKj/9ekwG6vrzUpa64wBCNSgXNRiA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95268},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"ae5767578cb356e4f95fb6efb66b52331aae3a0f","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","test:watch":"vitest","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"aida_joel","email":"joel@aida.agency"},"repository":{"url":"git+https://github.com/aida-ai/sdd-platform.git","type":"git","directory":"packages/sdd-mcp"},"_npmVersion":"10.9.3","description":"MCP server for SDD Platform - exposes spec, process, and session management as Claude tools","directories":{},"_nodeVersion":"22.18.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@ai_design_agency/sdd-core":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^2.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdd-mcp_1.2.0_1767583055230_0.24340814493971563","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@ai_design_agency/sdd-mcp","version":"1.3.0","description":"MCP server for SDD Platform - exposes spec, process, and session management as Claude tools","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"sdd-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","test":"vitest run","test:watch":"vitest","type-check":"tsc --noEmit","clean":"rm -rf dist","prepublishOnly":"npm run build"},"keywords":["sdd","mcp","model-context-protocol","claude","spec-driven-development","aida"],"author":{"name":"AIDA"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aida-ai/sdd-platform.git","directory":"packages/sdd-mcp"},"dependencies":{"@ai_design_agency/sdd-core":"^1.0.0","@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.3.0","vitest":"^2.0.0"},"_id":"@ai_design_agency/sdd-mcp@1.3.0","gitHead":"30e1ae5d3c6e0fe1fbea7fe8e9c4e68d1c5a7db2","bugs":{"url":"https://github.com/aida-ai/sdd-platform/issues"},"homepage":"https://github.com/aida-ai/sdd-platform#readme","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-/5+cQR3r/k8oH1+WwI9LPzsv/K677CAXVIt/+QaVzt5MU0owJGm40Xj1nGmhVNSVVAcgydZvl1XpCR5qRnTRNw==","shasum":"058a2ecbd13b49b652889b4985c1f239d83b0019","tarball":"https://registry.npmjs.org/@ai_design_agency/sdd-mcp/-/sdd-mcp-1.3.0.tgz","fileCount":38,"unpackedSize":97102,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAwBBxTey1ebNYgRjIf2LbWxv2A+46m8aPHfNh+YTEzCAiEAnx9D68OhyvTdCWfFczFuJ/KDJF6IWJcbdMCi7YCQcE0="}]},"_npmUser":{"name":"aida_joel","email":"joel@aida.agency"},"directories":{},"maintainers":[{"name":"aida_joel","email":"joel@aida.agency"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdd-mcp_1.3.0_1767650539893_0.4707319101473608"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-01T09:51:26.357Z","modified":"2026-01-05T22:02:20.280Z","1.0.0":"2026-01-01T09:51:26.704Z","1.2.0":"2026-01-05T03:17:35.365Z","1.3.0":"2026-01-05T22:02:20.063Z"},"bugs":{"url":"https://github.com/aida-ai/sdd-platform/issues"},"author":{"name":"AIDA"},"license":"MIT","homepage":"https://github.com/aida-ai/sdd-platform#readme","keywords":["sdd","mcp","model-context-protocol","claude","spec-driven-development","aida"],"repository":{"type":"git","url":"git+https://github.com/aida-ai/sdd-platform.git","directory":"packages/sdd-mcp"},"description":"MCP server for SDD Platform - exposes spec, process, and session management as Claude tools","maintainers":[{"name":"aida_joel","email":"joel@aida.agency"}],"readme":"# @ai_design_agency/sdd-mcp\n\nMCP (Model Context Protocol) server for the SDD Platform. Exposes spec, process, and session management as Claude-callable tools.\n\n## Overview\n\nThis package is a **thin HTTP client** that translates MCP tool calls into Platform API requests. All business logic, validation, and authorization remain centralized in the Platform API.\n\n```\nClaude Code → MCP Server → Platform API → Database\n```\n\n## Installation\n\n```bash\nnpm install @ai_design_agency/sdd-mcp\n```\n\n## Configuration\n\nThe MCP server requires two environment variables:\n\n```bash\nSDD_API_URL=https://your-platform-api.example.com\nSDD_API_TOKEN=your-bearer-token\n```\n\n### Claude Code Configuration\n\nAdd to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"sdd\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ai_design_agency/sdd-mcp\"],\n      \"env\": {\n        \"SDD_API_URL\": \"https://sdd-api.your-domain.com\",\n        \"SDD_API_TOKEN\": \"${SDD_API_TOKEN}\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Spec Management\n\n| Tool          | Description                             |\n| ------------- | --------------------------------------- |\n| `spec_create` | Create a new SDD specification          |\n| `spec_get`    | Get a spec by ID or spec_number         |\n| `spec_update` | Update spec content, section, or status |\n| `spec_list`   | List specs with optional filters        |\n| `spec_search` | Semantic search across specs            |\n\n### Process Management\n\n| Tool             | Description                        |\n| ---------------- | ---------------------------------- |\n| `process_list`   | List available processes/workflows |\n| `process_get`    | Get process details by ID          |\n| `process_search` | Semantic search across processes   |\n| `process_tests`  | Get test scenarios for a process   |\n| `process_create` | Create a new process definition    |\n| `process_update` | Update an existing process         |\n| `process_delete` | Delete a process definition        |\n\n**Note**: Write operations (`process_create`, `process_update`, `process_delete`) require a JWT token with `processes:write` scope.\n\n### Session Management\n\n| Tool             | Description                         |\n| ---------------- | ----------------------------------- |\n| `session_start`  | Start a new work session for a spec |\n| `session_update` | Update session notes                |\n| `session_end`    | End a work session                  |\n\n## Tool Examples\n\n### Create a Spec\n\n```json\n{\n  \"tool\": \"spec_create\",\n  \"arguments\": {\n    \"type\": \"FEA\",\n    \"title\": \"User Authentication\",\n    \"content\": \"# Feature: User Authentication\\n\\n## Summary\\n...\"\n  }\n}\n```\n\n### Search Specs\n\n```json\n{\n  \"tool\": \"spec_search\",\n  \"arguments\": {\n    \"query\": \"authentication login\",\n    \"type\": \"FEA\",\n    \"limit\": 5\n  }\n}\n```\n\n### Create a Process\n\n```json\n{\n  \"tool\": \"process_create\",\n  \"arguments\": {\n    \"name\": \"Spec Creation Workflow\",\n    \"description\": \"Standard workflow for creating SDD specifications\",\n    \"content\": \"# Spec Creation Workflow\\n\\n## Steps\\n1. Analyze request...\",\n    \"process_id\": \"spec-create\",\n    \"domain\": \"spec-lifecycle\"\n  }\n}\n```\n\n### Start a Session\n\n```json\n{\n  \"tool\": \"session_start\",\n  \"arguments\": {\n    \"spec_id\": \"uuid-or-spec-number\",\n    \"notes\": \"Starting implementation of auth feature\"\n  }\n}\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n\n# Type check\nnpm run type-check\n```\n\n## Architecture\n\nThis MCP server follows the **thin client pattern** established in INV-202512024:\n\n- **No Business Logic**: All validation, authorization, and workflow logic stays in Platform API\n- **Type Safety**: Uses `@ai_design_agency/sdd-core` for shared types\n- **Bearer Token Auth**: Token passed to Platform API in Authorization header\n- **Structured Errors**: API errors translated to MCP-friendly format\n\n## Related Packages\n\n- [`@ai_design_agency/sdd-core`](../sdd-core) - Shared TypeScript types\n\n## Spec Reference\n\n- **Spec ID**: FEA-202601002\n- **Parent Epic**: EPC-202512003 (SDD Future State Design)\n\n---\n\nBuilt by AIDA\n","readmeFilename":"README.md"}