{"id":37713104,"url":"https://github.com/zudsniper/mcp-v0","last_synced_at":"2026-01-16T13:21:43.684Z","repository":{"id":306853125,"uuid":"1025203044","full_name":"zudsniper/mcp-v0","owner":"zudsniper","description":"mcp server for v0.dev api ","archived":false,"fork":false,"pushed_at":"2025-08-06T15:23:44.000Z","size":167,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-06T17:29:54.260Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zudsniper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-23T22:33:08.000Z","updated_at":"2025-08-02T04:42:50.000Z","dependencies_parsed_at":"2025-07-28T03:29:32.397Z","dependency_job_id":"f1fe638e-f3e5-406b-8e0b-d2f54f7ca3a6","html_url":"https://github.com/zudsniper/mcp-v0","commit_stats":null,"previous_names":["zudsniper/mcp-v0"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/zudsniper/mcp-v0","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fmcp-v0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fmcp-v0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fmcp-v0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fmcp-v0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zudsniper","download_url":"https://codeload.github.com/zudsniper/mcp-v0/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fmcp-v0/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479033,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T13:21:43.047Z","updated_at":"2026-01-16T13:21:43.669Z","avatar_url":"https://github.com/zudsniper.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP v0.dev Server\n\nThis project implements an MCP (Model Context Protocol) server that integrates with the v0.dev API to facilitate delegated component generation for Next.js projects.\n\n## Features\n\n- **Generate Components**: Use the `generate-component` tool to create React/Next.js components by providing a natural language prompt.\n- **Apply Components**: Use the `apply-component` tool to apply generated files to your project with various merge strategies to prevent accidental overwrites.\n- **List Project Files**: Use the `list-project-files` tool to inspect your project structure.\n- **Read File**: Use the `read-file` tool to view the content of specific files.\n\n## Installation\n\n1.  Clone this repository:\n    ```bash\n    git clone https://github.com/zudsniper/mcp-v0.git\n    cd mcp-v0\n    ```\n2.  Install dependencies:\n    ```bash\n    npm install\n    ```\n3.  Create a `.env` file in the root directory and add your v0.dev API key and desired model:\n    ```\n    V0_API_KEY=YOUR_V0_API_KEY_HERE\n    V0_MODEL=v0-1.5-md\n    ```\n    Replace `YOUR_V0_API_KEY_HERE` with your actual v0.dev API key.\n\n## Usage\n\nTo start the MCP server, run:\n\n```bash\nnpm run start\n```\n\nIf installed globally via npm, you can also start the server with:\n\n```bash\nnpx mcp-v0-server\n```\n\nThe server will run and listen for MCP requests via `stdio`.\n\n### MCP Tools\n\n#### `generate-component`\n\n- **Description**: Generate a React/Next.js component using v0.dev API.\n- **Input**: \n  - `prompt`: (string) Description of the component to generate.\n  - `model`: (string, optional) Model to use (defaults to environment variable `V0_MODEL`).\n- **Output**: Returns the generated file contents as text.\n\n#### `apply-component`\n\n- **Description**: Apply generated component files to a project with configurable merge strategy.\n- **Input**: \n  - `files`: (array of objects) Each object has `name` (string) and `content` (string) of the file.\n  - `targetPath`: (string) Target directory path where files should be applied.\n  - `mergeStrategy`: (enum) How to handle existing files. Options: `\"overwrite\"`, `\"backup\"`, `\"merge\"`, `\"skip-existing\"`, `\"preview\"`.\n  - `backupSuffix`: (string, optional) Suffix for backup files (default: `.backup`).\n- **Output**: A summary of the application process.\n\n##### Merge Strategies:\n\n- `overwrite`: Overwrites existing files.\n- `backup`: Backs up existing files before overwriting them.\n- `merge`: Appends new content to existing files (simple append for now).\n- `skip-existing`: Skips applying files if they already exist.\n- `preview`: Shows what would happen without actually applying changes.\n\n#### `list-project-files`\n\n- **Description**: List files in a project directory with optional filtering.\n- **Input**: \n  - `projectPath`: (string) Path to the project directory.\n  - `pattern`: (string, optional) File pattern to match (e.g., `*.tsx`, `*.js`).\n  - `maxDepth`: (number, optional) Maximum directory depth to traverse (default: 3).\n- **Output**: A list of relative file paths.\n\n#### `read-file`\n\n- **Description**: Read the content of a specific file.\n- **Input**: \n  - `filePath`: (string) Path to the file to read.\n- **Output**: The content of the file.\n\n## Development\n\nTo compile the TypeScript code:\n\n```bash\nnpm run build\n```\n\n## Contributing\n\nFeel free to open issues or pull requests on the GitHub repository.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzudsniper%2Fmcp-v0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzudsniper%2Fmcp-v0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzudsniper%2Fmcp-v0/lists"}