# MCP - Agent to VSC

Local MCP server that connects an MCP-capable VS Code agent such as Cline to OpenAI and workspace file tools.

## Flow

`Cline / VS Code -> MCP (stdio) -> local Node.js server -> OpenAI API`

## Tools

- `ask_ai` — send prompts to OpenAI
- `read_file` — read workspace files
- `write_file` — write workspace files
- `list_files` — list workspace files/directories
- `workspace_info` — inspect configuration

## Install

Requirements: Node.js 20+.

```bash
npm install
```

Set `OPENAI_API_KEY` in the environment. Never commit the real key.

PowerShell:

```powershell
$env:OPENAI_API_KEY="sk-..."
npm start
```

## Cline

Add this server to Cline's MCP settings:

```json
{
  "mcpServers": {
    "mcp-agent-to-vsc": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-agent-to-vsc\\server.mjs"],
      "env": {
        "OPENAI_API_KEY": "YOUR_API_KEY",
        "OPENAI_MODEL": "gpt-5.6",
        "WORKSPACE_ROOT": "C:\\path\\to\\your\\workspace"
      }
    }
  }
}
```

For local VS Code MCP configuration, see `.vscode/mcp.json`.

## Security

The server restricts file access to `WORKSPACE_ROOT`. Keep your API key in an environment variable or an ignored `.env` file.