# mcp-vsc-button-gen

A tiny MCP server that generates VS Code MCP install buttons (Stable + Insiders) for NPX-based servers.

- Runtime: Node (stdio transport)
- Command: npx mcp-vsc-button-gen

You can run it directly via NPX (no install):

```sh
npx mcp-vsc-button-gen
```

## Install in VS Code

[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=vsc-buttons&config=%7B%22command%22%3A%22node%22%2C%22args%22%3A%5B%22dist%2Findex.js%22%5D%7D)
[![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=vsc-buttons&config=%7B%22command%22%3A%22node%22%2C%22args%22%3A%5B%22dist%2Findex.js%22%5D%7D&quality=insiders)

## Tools

- make_install_buttons
  - Input: { name: string, inputs?: MCPInput[], config?: CommandConfig }
  - Output: Markdown string with two badges/links.
- from_mcp_config
  - Input: { name: string, mcp: { inputs?: MCPInput[], config?: CommandConfig } }
  - Output: Markdown string with two badges/links.
- copilot_buttons_from_raw
  - Input: { kind: 'chat-instructions' | 'chat-prompt' | 'chat-mode', url: string }
  - Output: Markdown with two badges linking to vscode.dev/insiders redirect for Install
- copilot_buttons_from_github
  - Input: { kind: 'chat-instructions' | 'chat-prompt' | 'chat-mode', owner: string, repo: string, path: string, branch?: string }
  - Output: Markdown with two badges as above

Types:
- MCPInput: { type: 'promptString', id: string, description?: string, password?: boolean }
- CommandConfig: { command: 'npx', args?: string[], env?: Record<string,string> }

## Example

Input:
```json
{
  "name": "supabase",
  "inputs": [
    { "type": "promptString", "id": "supabase-access-token", "description": "Supabase personal access token", "password": true }
  ],
  "config": {
    "command": "npx",
    "args": ["-y", "@supabase/mcp-server-supabase@latest", "--readonly", "--project-ref=$SUPABASE_MCP_PROJECT_REF"],
    "env": {
      "SUPABASE_ACCESS_TOKEN": "${input:supabase-access-token}",
      "SUPABASE_MCP_PROJECT_REF": "${input:supabase-project-ref}"
    }
  }
}
```

Output: two markdown buttons for Stable and Insiders.

## Local dev

- Install deps
- Build
- Run via stdio (for manual testing)

### Quickstart

```sh
npm i
npm run build
node dist/index.js
```

You can also run in dev:

```sh
npm run dev
```

This server speaks MCP stdio; integrate with an MCP client to call tools.