{"_id":"@balbir1311/projectspec-mcp","name":"@balbir1311/projectspec-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@balbir1311/projectspec-mcp","version":"1.0.0","description":"MCP server for validating Markdown project specifications and generating DOCX, PDF and HTML documents.","type":"module","bin":{"projectspec-mcp":"dist/index.js"},"engines":{"node":">=20"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","pack:check":"npm run build && npm pack --dry-run"},"keywords":["mcp","model-context-protocol","markdown","docx","pdf","html","documentation","ai"],"license":"MIT","dependencies":{"@modelcontextprotocol/server":"^2.0.0","docx":"^9.5.1","markdown-it":"^14.1.0","pdfkit":"^0.17.2","zod":"^4.0.0"},"devDependencies":{"@types/markdown-it":"^14.1.2","@types/node":"^24.0.0","@types/pdfkit":"^0.13.9","tsx":"^4.20.0","typescript":"^5.9.0"},"_id":"@balbir1311/projectspec-mcp@1.0.0","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-Wlou2d9coCIj4Jye8lG3qHDHMps1YKPUHcy4cXsIoJGerp0nrPXRJWlm2NJcSw5xga73C8O0cMlAy+Lyf+PMWA==","shasum":"262e9651bb380061bf468170d169a05c9fd009b1","tarball":"https://registry.npmjs.org/@balbir1311/projectspec-mcp/-/projectspec-mcp-1.0.0.tgz","fileCount":10,"unpackedSize":28988,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDHryLTBlFSDFUDpNAGkj5gxM1F8sET9rtotj5Nk6IpOwIgAveXCooU8v5QmTvsavTci5WDHxVH1GnUdQcJy+AL50U="}]},"_npmUser":{"name":"balbir1311","email":"balbirbisht560@gmail.com"},"directories":{},"maintainers":[{"name":"balbir1311","email":"balbirbisht560@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/projectspec-mcp_1.0.0_1787299392416_0.8870471327691298"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-21T08:03:12.293Z","1.0.0":"2026-08-21T08:03:12.571Z","modified":"2026-08-21T08:03:12.784Z"},"maintainers":[{"name":"balbir1311","email":"balbirbisht560@gmail.com"}],"description":"MCP server for validating Markdown project specifications and generating DOCX, PDF and HTML documents.","keywords":["mcp","model-context-protocol","markdown","docx","pdf","html","documentation","ai"],"license":"MIT","readme":"# ProjectSpec MCP\n\nAn MCP server that lets AI clients validate Markdown project specifications and generate DOCX, PDF and HTML documents.\n\nBuilt for local MCP execution, so the Markdown files stay on the user's machine.\n\n## Requirements\n\n- Node.js 20+\n- npm\n\n## Install from npm\n\nAfter publishing:\n\n```bash\nnpm install -g @YOUR_NPM_SCOPE/projectspec-mcp\n```\n\nOr run without a global installation:\n\n```bash\nnpx -y @YOUR_NPM_SCOPE/projectspec-mcp\n```\n\n## MCP configuration\n\nFor clients that support stdio MCP servers:\n\n```json\n{\n  \"mcpServers\": {\n    \"projectspec\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@YOUR_NPM_SCOPE/projectspec-mcp\"\n      ]\n    }\n  }\n}\n```\n\nIf you installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"projectspec\": {\n      \"command\": \"projectspec-mcp\"\n    }\n  }\n}\n```\n\n## Tools\n\n### validate_project_spec\n\nValidates a Markdown specification and returns:\n\n- completion score\n- screen count\n- API count\n- UI section count\n- functionality section count\n- missing sections\n- warnings\n\nExample AI request:\n\n> Validate my project-spec.md.\n\n### convert_markdown\n\nConverts a Markdown file to:\n\n- DOCX\n- PDF\n- HTML\n\nExample:\n\n> Convert project-spec.md to DOCX.\n\n### generate_project_document\n\nValidates the specification and generates a document in one call.\n\nExample:\n\n> Validate project-spec.md and generate TrackOra-Documentation.pdf.\n\n## Recommended Markdown structure\n\n```markdown\n# Project\n\n## Project\n\nDescription.\n\n## Screen: Login\n\n### UI\n\n- Email\n- Password\n- Login button\n\n### API\n\n#### POST /api/auth/login\n\nRequest:\n\n```json\n{\n  \"email\": \"string\",\n  \"password\": \"string\"\n}\n```\n\n### Functionality\n\n1. Validate input.\n2. Call API.\n3. Navigate to dashboard.\n```\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm start\n```\n\nTest with the MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector npx tsx src/index.ts\n```\n\n## Publish to npm\n\n1. Replace `@YOUR_NPM_SCOPE/projectspec-mcp` in `package.json` and README with your actual package name.\n2. Run:\n\n```bash\nnpm login\nnpm run build\nnpm pack --dry-run\nnpm publish --access public\n```\n\nFor an unscoped package, for example `projectspec-mcp`, use:\n\n```bash\nnpm publish\n```\n\n## Important\n\nThe server uses stdio. MCP protocol messages use stdout, so the server only logs diagnostics to stderr.\n\nThis package processes local files. A client must give the MCP process a path it can access.\n","readmeFilename":"README.md","_rev":"1-8d92e5cf9ec38ae4c3380119364f43cd"}