{"id":28431760,"url":"https://github.com/block/vscode-mcp","last_synced_at":"2025-07-23T12:08:33.187Z","repository":{"id":282303083,"uuid":"948067228","full_name":"block/vscode-mcp","owner":"block","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-28T19:07:18.000Z","size":266,"stargazers_count":64,"open_issues_count":3,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-17T13:12:29.958Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/block.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-03-13T17:36:23.000Z","updated_at":"2025-06-17T11:06:45.000Z","dependencies_parsed_at":"2025-03-28T20:22:05.900Z","dependency_job_id":"f3450f54-2f5a-45eb-91b1-cac58eabe5a0","html_url":"https://github.com/block/vscode-mcp","commit_stats":null,"previous_names":["block/code-mcp","block/vscode-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/block/vscode-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fvscode-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fvscode-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fvscode-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fvscode-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/block","download_url":"https://codeload.github.com/block/vscode-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fvscode-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266673581,"owners_count":23966376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2025-06-05T16:08:18.136Z","updated_at":"2025-07-23T12:08:33.176Z","avatar_url":"https://github.com/block.png","language":"TypeScript","funding_links":[],"categories":["Developer Tools","Real-Time Collaboration"],"sub_categories":["How to Submit"],"readme":"# VSCode MCP\n\nThis monorepo contains the VSCode MCP Server and its companion VSCode Extension, which together enable AI agents and assistants, like Goose or Claude, to interact with VSCode through the Model Context Protocol.\n\n## Project Structure\n\n```\nvscode-mcp/\n├── server/    # MCP server implementation\n└── extension/ # VS Code extension\n```\n\n## Quick Start\n\n1. Install the MCP Server\n\n```bash\nnpx vscode-mcp-server install\n```\n\n2. Install the MCP Extension\n\n\u003e [MCP Extension](https://marketplace.visualstudio.com/items?itemName=block.vscode-mcp-extension)\n\n## Configuration\n\n### Goose Desktop Setup\n\n![Goose Settings](assets/GooseSettings.png)\n\n- ID: `code-mcp`\n- Name: `VS Code`\n- Description: `Allows interaction with VS Code through the Model Context Protocol`\n- Command: `npx vscode-mcp-server`\n\n### Claude Desktop Setup\n\nAdd this to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"vscode-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"vscode-mcp-server\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Available Tools\n\nThe Code MCP server provides the following tools for AI agents to interact with VS Code:\n\n### `create_diff`\n\nCreates and shows a diff for modifying existing files:\n\n- Shows changes preview before applying\n- Requires user approval\n- Only works with existing files\n\n### `open_file`\n\nOpens files in the VS Code editor:\n\n- Used for viewing new or modified files\n\n### `open_project`\n\nOpens a project folder in VS Code:\n\n- Sets up working directory for AI agent\n\n### `check_extension_status`\n\nChecks if extension is installed and responding\n\n### `get_extension_port`\n\nGets the port number for VS Code MCP Extension\n\n### `list_available_projects`\n\nShows projects from port registry file\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\nCopyright 2025 Block, Inc.\n\nThis product includes software developed at [Block, Inc.](https://block.xyz/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock%2Fvscode-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblock%2Fvscode-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock%2Fvscode-mcp/lists"}