Communitygithub.com

powlite32/google-docs-mcp-server

๐Ÿ“„ LLM๊ณผ Google Docs๋ฅผ ์—ฐ๊ฒฐํ•˜์—ฌ ๋” ์Šค๋งˆํŠธํ•œ ์›Œํฌํ”Œ๋กœ์šฐ์™€ ํšจ์œจ์ ์ธ ๋ฌธ์„œ ๊ด€๋ฆฌ๋ฅผ ์ง€์›ํ•˜๋Š” ๋น„๊ณต์‹ MCP ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

google-docs-mcp-server๋ž€ ๋ฌด์—‡์ธ๊ฐ€์š”?

์ด MCP ์„œ๋ฒ„๋Š” LLM(๋Œ€๊ทœ๋ชจ ์–ธ์–ด ๋ชจ๋ธ)์ด Google Docs ๋ฌธ์„œ์™€ ์ง์ ‘ ์ƒํ˜ธ์ž‘์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ์„ค๊ณ„๋œ ๋น„๊ณต์‹ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค. ๊ฐœ๋ฐœ์ž์™€ AI ์—์ด์ „ํŠธ ์‚ฌ์šฉ์ž๊ฐ€ Google Docs ๋ฌธ์„œ์˜ ๋‚ด์šฉ์„ ์ฝ๊ณ , ๊ฒ€์ƒ‰ํ•˜๋ฉฐ, ์ˆ˜์ •ํ•  ์ˆ˜ ์žˆ๋Š” ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜์—ฌ ๋ฌธ์„œ ๊ด€๋ฆฌ ์ž‘์—…์„ ์ž๋™ํ™”ํ•˜๊ณ  ํšจ์œจ์„ฑ์„ ๋†’์ž…๋‹ˆ๋‹ค. Cursor, Claude Code, Codex์™€ ๊ฐ™์€ AI ์ฝ”๋”ฉ ์—์ด์ „ํŠธ ํ”Œ๋žซํผ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, MCP(Model Context Protocol)๋ฅผ ํ†ตํ•ด LLM์ด Google Docs API๋ฅผ ๊ฐ„์ ‘์ ์œผ๋กœ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค. ์ด ์„œ๋ฒ„๋ฅผ ํ†ตํ•ด ์‚ฌ์šฉ์ž๋Š” ์ž์—ฐ์–ด ๋ช…๋ น์œผ๋กœ ๋ฌธ์„œ๋ฅผ ์ƒ์„ฑํ•˜๊ฑฐ๋‚˜ ํŽธ์ง‘ํ•  ์ˆ˜ ์žˆ์–ด ๋ฐ˜๋ณต์ ์ธ ๋ฌธ์„œ ์ž‘์—…์˜ ์ƒ์‚ฐ์„ฑ์„ ํฌ๊ฒŒ ํ–ฅ์ƒ์‹œํ‚ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ง€์› ๋Œ€์ƒ~Claude Code~Codex CLI~Cursor
npx skills add powlite32/google-docs-mcp-server

์ฆ๊ฒจ ์‚ฌ์šฉํ•˜๋Š” AI์—๊ฒŒ ๋ฌผ์–ด๋ณด๊ธฐ

์ด ์—์ด์ „ํŠธ ์Šคํ‚ฌ์ด ๋ฏธ๋ฆฌ ๋กœ๋“œ๋œ ์ƒˆ ์ฑ„ํŒ…์„ ์—ฝ๋‹ˆ๋‹ค.

๋ฌธ์„œ

google-docs-mcp-server์€(๋Š”) ๋ฌด์—‡์„ ํ•˜๋‚˜์š”?

๐Ÿ“„ LLM๊ณผ Google Docs๋ฅผ ์—ฐ๊ฒฐํ•˜์—ฌ ๋” ์Šค๋งˆํŠธํ•œ ์›Œํฌํ”Œ๋กœ์šฐ์™€ ํšจ์œจ์ ์ธ ๋ฌธ์„œ ๊ด€๋ฆฌ๋ฅผ ์ง€์›ํ•˜๋Š” ๋น„๊ณต์‹ MCP ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

๊ฐœ์š”

์ด ํ”„๋กœ์ ํŠธ๋Š” **Model Context Protocol (MCP)**์„ ์‚ฌ์šฉํ•˜์—ฌ LLM(๋Œ€๊ทœ๋ชจ ์–ธ์–ด ๋ชจ๋ธ)์ด Google Docs ๋ฌธ์„œ์™€ ์ƒํ˜ธ์ž‘์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ๋น„๊ณต์‹ ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. ๋ฌธ์„œ ์ฝ๊ธฐ, ๊ฒ€์ƒ‰, ํŽธ์ง‘, ์ƒ์„ฑ ๋“ฑ์˜ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ๋Šฅ

  • ๋ฌธ์„œ ๋‚ด์šฉ ์ฝ๊ธฐ ๋ฐ ๊ฒ€์ƒ‰
  • ์ƒˆ ๋ฌธ์„œ ์ƒ์„ฑ
  • ๊ธฐ์กด ๋ฌธ์„œ ํŽธ์ง‘ ๋ฐ ์ˆ˜์ •
  • ๋ฌธ์„œ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์กฐํšŒ

์„ค์น˜ ๋ฐ ์„ค์ •

ํ•„์ˆ˜ ์กฐ๊ฑด

  • Node.js 18+
  • Google Cloud Platform ํ”„๋กœ์ ํŠธ ๋ฐ ํ™œ์„ฑํ™”๋œ Google Docs API
  • ์„œ๋น„์Šค ๊ณ„์ • JSON ํ‚ค ํŒŒ์ผ

์„ค์น˜

npm install @modelcontextprotocol/sdk googleapis

ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •

export GOOGLE_SERVICE_ACCOUNT_KEY='{
  "type": "service_account",
  "project_id": "...",
  ...
}'
export GOOGLE_DOCS_ACCESS_TOKEN='your-access-token'

์‚ฌ์šฉ๋ฒ•

MCP ํด๋ผ์ด์–ธํŠธ ๊ตฌ์„ฑ

๋‹ค์Œ์€ claude_desktop_config.json ์˜ˆ์‹œ์ž…๋‹ˆ๋‹ค:

{
  "mcpServers": {
    "google-docs": {
      "command": "node",
      "args": ["path/to/server.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "{...}",
        "GOOGLE_DOCS_ACCESS_TOKEN": "..."
      }
    }
  }
}

์ง€์›๋˜๋Š” ๋„๊ตฌ

๋„๊ตฌ ์ด๋ฆ„์„ค๋ช…
read_document๋ฌธ์„œ ID๋กœ ๋ฌธ์„œ ๋‚ด์šฉ ์ฝ๊ธฐ
search_documents์ฟผ๋ฆฌ๋กœ ๋ฌธ์„œ ๊ฒ€์ƒ‰
create_document์ƒˆ ๋ฌธ์„œ ์ƒ์„ฑ
update_document๊ธฐ์กด ๋ฌธ์„œ ๋‚ด์šฉ ์—…๋ฐ์ดํŠธ

๊ธฐ์—ฌ

๋ฒ„๊ทธ ๋ฆฌํฌํŠธ, ๊ธฐ๋Šฅ ์ œ์•ˆ, ํ’€ ๋ฆฌํ€˜์ŠคํŠธ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค.

๋ผ์ด์„ ์Šค

MIT

๊ด€๋ จ ์Šคํ‚ฌ