{"_id":"@botanicastudios/deepcoding-artifacts-mcp","_rev":"2-5f68a916e41a19297ad7312cf3f8b1e0","name":"@botanicastudios/deepcoding-artifacts-mcp","dist-tags":{"latest":"0.0.3"},"versions":{"0.0.1":{"name":"@botanicastudios/deepcoding-artifacts-mcp","version":"0.0.1","keywords":["mcp","model-context-protocol","artifacts","deepcoding","claude"],"author":{"name":"DeepCoding"},"license":"MIT","_id":"@botanicastudios/deepcoding-artifacts-mcp@0.0.1","maintainers":[{"name":"tnjm","email":"toby.m@rsden.com"}],"bin":{"artifacts-mcp":"dist/index.js"},"dist":{"shasum":"5d29a30c13205a93a79b903bd05ed4952e2ead61","tarball":"https://registry.npmjs.org/@botanicastudios/deepcoding-artifacts-mcp/-/deepcoding-artifacts-mcp-0.0.1.tgz","fileCount":6,"integrity":"sha512-Mg8atuYMkEtSYd6ezeQehPxE/cO8QboPL47uqq/YNIedTdhtJc8rvMKIN6/G+oMyvgeFGhiy8uqNsu8KyGlKcQ==","signatures":[{"sig":"MEYCIQD3H2U+OCefHlH5H+DwaaDbHmPA4jlnoHr5scsC88aX4gIhAPdmD0IzE2RUxNkuFKXhpUtwxIigG/TE3+cS8XqOL+4M","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28931},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b6e71dbc04818bb0119d91f40f8a7f4705c7731e","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"tnjm","email":"toby.m@rsden.com"},"_npmVersion":"10.9.2","description":"MCP server for managing artifacts in DeepCoding apps","directories":{},"_nodeVersion":"22.15.0","dependencies":{"zod":"^3.22.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/deepcoding-artifacts-mcp_0.0.1_1750023002449_0.02565239778485351","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@botanicastudios/deepcoding-artifacts-mcp","version":"0.0.3","description":"MCP server for managing artifacts in DeepCoding apps","type":"module","main":"dist/index.js","bin":{"artifacts-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","artifacts","deepcoding","claude"],"author":{"name":"DeepCoding"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.6.0","node-fetch":"^3.3.2","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.0.0"},"_id":"@botanicastudios/deepcoding-artifacts-mcp@0.0.3","gitHead":"44eb19819769b0e68c5275cfefbeb12f418b52f2","types":"./dist/index.d.ts","_nodeVersion":"22.15.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-SePn2ywRjVp9Uu2MTIsqMkinKbYwR2oA5AjXs62lD3qcDlpEEQxxAfv0Lc5ZBC9fGGOHLY1i73Olpt8KWD7DvA==","shasum":"29be96fdeab2f7a318c8e872b888409e1ab56364","tarball":"https://registry.npmjs.org/@botanicastudios/deepcoding-artifacts-mcp/-/deepcoding-artifacts-mcp-0.0.3.tgz","fileCount":6,"unpackedSize":33417,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC3hnvbiBlWESY7pg/uNXc+17pBEjdAARsZIE/IL6TiQgIgc980zrK1PjuhvuETH0/Kv5ApNgND/xZMmxIBzN6V6Hw="}]},"_npmUser":{"name":"tnjm","email":"toby.m@rsden.com","actor":{"name":"tnjm","email":"toby.m@rsden.com","type":"user"}},"directories":{},"maintainers":[{"name":"tnjm","email":"toby.m@rsden.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/deepcoding-artifacts-mcp_0.0.3_1750345247733_0.708404186059503"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-15T21:30:02.336Z","modified":"2025-06-19T15:00:48.119Z","0.0.1":"2025-06-15T21:30:02.635Z","0.0.3":"2025-06-19T15:00:47.933Z"},"author":{"name":"DeepCoding"},"license":"MIT","keywords":["mcp","model-context-protocol","artifacts","deepcoding","claude"],"description":"MCP server for managing artifacts in DeepCoding apps","maintainers":[{"name":"tnjm","email":"toby.m@rsden.com"}],"readme":"# Artifacts MCP Server\n\nA Model Context Protocol (MCP) server that provides CRUD operations for artifacts in DeepCoding applications.\n\n## Features\n\n- **list_artifacts**: List all artifacts for the current app\n- **get_artifact**: Get a specific artifact by ID\n- **create_artifact**: Create a new artifact\n- **update_artifact**: Update an existing artifact\n- **delete_artifact**: Delete an artifact\n\n## Installation\n\n```bash\nnpm install -g @deepcoding/artifacts-mcp\n```\n\n## Usage\n\nThe MCP server is designed to be used within the DeepCoding Runner environment. It requires the following environment variables:\n\n- `APP_STAGE_TOKEN`: Authentication token for the app stage\n- `RUNNER_BASE_URL`: Base URL of the Runner API (defaults to http://localhost:3000)\n\n### With Claude CLI\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"artifacts\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@deepcoding/artifacts-mcp@latest\"],\n      \"env\": {\n        \"APP_STAGE_TOKEN\": \"your-app-stage-token\",\n        \"RUNNER_BASE_URL\": \"http://localhost:3000\"\n      }\n    }\n  }\n}\n```\n\n### Integration in DeepCoding Runner\n\nThe server is automatically configured and injected into Claude instances running in the DeepCoding Runner environment.\n\n## API\n\nAll operations are scoped to the app associated with the provided `APP_STAGE_TOKEN`.\n\n### list_artifacts\n\nLists all artifacts for the current app.\n\n**Parameters:** None\n\n**Returns:** A formatted list of artifacts with IDs, names, types, and creation dates.\n\n### get_artifact\n\nRetrieves a specific artifact by ID.\n\n**Parameters:**\n\n- `id` (string): The ID of the artifact to retrieve\n\n**Returns:** Full artifact details including content.\n\n### create_artifact\n\nCreates a new artifact.\n\n**Parameters:**\n\n- `name` (string, required): The name of the artifact\n- `type` (string, required): The type of artifact (e.g., 'document', 'code', 'config', 'image')\n- `description` (string, optional): Description of the artifact\n- `content` (string, optional): Content of the artifact. For images, provide a file path (relative to /workspace) or URL\n\n**Returns:** Confirmation with the created artifact details. For image artifacts, also returns the image data in MCP image format with base64 data and proper MIME type (supports JPEG and PNG).\n\n### update_artifact\n\nUpdates an existing artifact.\n\n**Parameters:**\n\n- `id` (string, required): The ID of the artifact to update\n- `name` (string, optional): New name for the artifact\n- `type` (string, optional): New type for the artifact\n- `description` (string, optional): New description for the artifact\n- `content` (string, optional): New content for the artifact\n\n**Returns:** Confirmation with the updated artifact details.\n\n### delete_artifact\n\nDeletes an artifact.\n\n**Parameters:**\n\n- `id` (string, required): The ID of the artifact to delete\n\n**Returns:** Confirmation of deletion with the artifact name and ID.\n\n## Image Handling\n\nWhen creating artifacts with `type: \"image\"`, the MCP server provides enhanced functionality:\n\n- **Local Files**: Provide a file path relative to `/workspace` (e.g., `\"images/photo.jpg\"`)\n- **Remote URLs**: Provide a full URL (e.g., `\"https://example.com/image.png\"`)\n- **Supported Formats**: JPEG (.jpg, .jpeg) and PNG (.png)\n- **MCP Response**: Returns both text confirmation and the actual image as base64 data with proper MIME type\n\nExample usage:\n\n```javascript\n// Local file\ncreate_artifact({\n  name: \"Project Logo\",\n  type: \"image\",\n  content: \"assets/logo.png\",\n});\n\n// Remote URL\ncreate_artifact({\n  name: \"Reference Image\",\n  type: \"image\",\n  content: \"https://example.com/reference.jpg\",\n});\n```\n\n## Security\n\n- All requests are authenticated using the `APP_STAGE_TOKEN`\n- Operations are scoped to the app associated with the token\n- Network communication uses HTTPS in production environments\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in development mode\nnpm run dev\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}