Automation

MCP for Cursor IDE

เชื่อมเครื่องมือช่วยงาน docs ของ Svelora เข้ากับ Cursor IDE ผ่าน MCP เพื่อให้ Agent เรียก tool ได้ตรง ๆ เช่น list slugs, ดึง section snippets, และ render shiki

After `bun add svelora`

ติดตั้งแพ็กเกจในโปรเจกต์ของคุณก่อนด้วย bun add svelora
เพิ่ม config MCP ใน .cursor/mcp.json ของโปรเจกต์นั้น
Restart Cursor 1 ครั้ง เพื่อให้โหลด MCP servers ใหม่
เข้า Agent Mode แล้วลองเรียก tools ได้ทันที

Install

                bun add svelora

Cursor Config For Consumer App

ถ้าคุณติดตั้งผ่าน npm package ให้ชี้ไปที่ไฟล์ server ใน node_modules/svelora/dist/mcp/server.mjs

mcp.json

                {
  "mcpServers": {
    "svelora-docs": {
      "type": "stdio",
      "command": "node",
      "args": ["./node_modules/svelora/dist/mcp/server.mjs"],
      "cwd": "${workspaceFolder}"
    }
  }
}

mcp.json via bin

                {
  "mcpServers": {
    "svelora-docs": {
      "type": "stdio",
      "command": "svelora-mcp-docs",
      "cwd": "${workspaceFolder}"
    }
  }
}

ถ้าไม่อยากเขียนเอง สามารถ copy template ที่แพ็กไปกับ package ได้จาก path นี้

template path

                ./node_modules/svelora/dist/mcp/cursor.mcp.json

หรือใช้ helper command นี้เพื่อสร้าง .cursor/mcp.json ให้ทันที

install template

                svelora-mcp-install-template

overwrite existing template

                svelora-mcp-install-template --force

Recommended Script For Consumer App

ถ้าต้องการคำสั่งสั้น ๆ ในโปรเจกต์ของคุณ ให้เพิ่ม script นี้ใน package.json

package.json

                {
  "scripts": {
    "mcp:svelora-docs": "node ./node_modules/svelora/dist/mcp/server.mjs"
  }
}

package.json via export

                {
  "scripts": {
    "mcp:svelora-docs": "node --eval \"import('svelora/mcp/server')\""
  }
}

package.json install template

                {
  "scripts": {
    "mcp:install-template": "node ./node_modules/svelora/dist/mcp/install-template.mjs"
  }
}

Run Server From Package

Command

                node ./node_modules/svelora/dist/mcp/server.mjs

Use From The Svelora Repo

ถ้าคุณเปิด repo นี้โดยตรง ยังใช้ workflow เดิมได้ผ่าน bun run mcp:svelora-docs

repo .cursor/mcp.json

                {
  "mcpServers": {
    "svelora-docs": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "mcp:svelora-docs"],
      "cwd": "${workspaceFolder}"
    }
  }
}

repo command

                bun run mcp:svelora-docs

Available Tools

Tools จะปรากฏใน Cursor MCP tools เมื่อเปิดใช้งานสำเร็จ

Tools

                - svelora_docs_list_slugs
- svelora_docs_get_page_source { slug }
- svelora_docs_get_section_snippets { slug }
- svelora_docs_render_shiki { code, isDarkMode? }

Cursor Prompt Examples

Prompts

                - "List docs slugs and summarize the available components and hooks"
- "Get section snippets for select-menu and summarize all sections"
- "Render shiki for this snippet (dark=false) and return the HTML"

Notes

consumer app ไม่จำเป็นต้องมี source docs ของ repo เพราะ MCP จะอ่าน data ที่ pack มากับแพ็กเกจ
config แบบ package แนะนำให้ใช้ node เพื่อไม่ต้องพึ่ง bun ตอนรัน MCP server
ตอนนี้แพ็กเกจมีทั้ง bin: svelora-mcp-docs, bin: svelora-mcp-install-template, export path svelora/mcp/server, และ template svelora/mcp/cursor-template
ถ้าเปิด repo นี้โดยตรงยังใช้คำสั่ง bun run mcp:svelora-docs ได้เหมือนเดิม
helper install จะไม่เขียนทับไฟล์เดิม ยกเว้นคุณส่ง --force
อย่าใส่ secrets ลงใน mcp.json ตรง ๆ ให้ใช้ env vars แทน