# mcp-vn

MCP server chạy local qua stdio, cung cấp:

- `introduction` — mô tả server và các tool sẵn có.
- `generate_image` — sinh ảnh từ prompt qua Azure OpenAI (`gpt-image-2`).

## Cài đặt & build

```bash
npm install
npm run build
```

## Biến môi trường

| Biến | Bắt buộc | Mô tả |
| --- | --- | --- |
| `AZURE_OPENAI_ENDPOINT` | có | Endpoint Azure Cognitive Services, vd `https://<resource>.cognitiveservices.azure.com` |
| `AZURE_OPENAI_API_KEY` | có | API key Azure |
| `AZURE_OPENAI_IMAGE_DEPLOYMENT` | không | Tên deployment, mặc định `gpt-image-2` |
| `AZURE_OPENAI_API_VERSION` | không | Mặc định `2024-02-01` |

## Kết nối từ app khác (Claude Desktop / Claude Code)

Thêm vào MCP config (vd `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "mcp-vn": {
      "command": "npx",
      "args": ["-y", "github:vntuananhbui/mcp-vn"],
      "env": {
        "AZURE_OPENAI_ENDPOINT": "https://your-resource.cognitiveservices.azure.com",
        "AZURE_OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}
```

`npx` sẽ tự clone + build repo từ GitHub khi chạy lần đầu.