Máy chủ Google Sheets MCP

Máy chủ “Google Sheets” MCP làm gì?

Google Sheets MCP (Model Context Protocol) Server là một công cụ dựa trên TypeScript giúp các trợ lý AI tương tác an toàn với Google Sheets thông qua các công cụ có kiểu rõ ràng. Đóng vai trò cầu nối giữa các tác nhân AI và API Google Sheets/Drive, nó cho phép tự động hóa mạnh mẽ và các quy trình xử lý dữ liệu. Máy chủ hỗ trợ cả xác thực OAuth2 và Tài khoản Dịch vụ, phù hợp với nhiều yêu cầu bảo mật khác nhau. Vai trò chính của nó là giúp nhà phát triển và quy trình AI thực hiện các tác vụ như tạo bảng tính, đọc và ghi dữ liệu ô, quản lý sheet/tab và chia sẻ tài liệu—tất cả đều theo lập trình và an toàn. Việc tích hợp này giúp tối ưu hóa các thao tác như truy vấn kiểu cơ sở dữ liệu, chỉnh sửa cộng tác và tự động hóa quy trình ngay trong Google Sheets, nâng cao hiệu suất và phát triển ứng dụng dựa trên AI.

Danh sách Prompt

Không có mẫu prompt rõ ràng nào được ghi tài trong kho mã nguồn.

Danh sách Tài nguyên

Không có tài nguyên rõ ràng nào được ghi tài trong kho mã nguồn.

Danh sách Công cụ

• create
  Tạo bảng tính mới và có thể chuyển vào thư mục Drive chỉ định.
• listSheets
  Liệt kê tất cả các tab sheet trong một bảng tính.
• renameSheet
  Đổi tên một tab sheet có sẵn.
• createSheet
  Thêm tab sheet mới vào bảng tính.
• spreadsheetInfo
  Lấy metadata (tiêu đề, ID sheet, thuộc tính lưới) của một bảng tính.
• listSpreadsheets
  Liệt kê tất cả bảng tính trong thư mục Drive cấu hình hoặc My Drive.
• shareSpreadsheet
  Chia sẻ bảng tính với người dùng (đọc/bình luận/ghi) và gửi thông báo.
• sheetData
  Đọc giá trị ô từ một sheet và phạm vi (hoặc toàn bộ sheet).
• updateCells
  Ghi một mảng 2D giá trị vào phạm vi kiểu A1.
• batchUpdate
  Thực hiện nhiều cập nhật phạm vi trong một yêu cầu.
• addRows / addColumns
  Chèn hàng hoặc cột vào vị trí chỉ định.
• copySheet
  Sao chép tab sheet giữa các bảng tính, có thể đổi tên.

Ứng dụng của MCP Server này

• Tạo và quản lý bảng tính tự động
  Dễ dàng tạo bảng tính mới, thêm hoặc đổi tên sheet/tab, sắp xếp tập tin trong Google Drive—all thông qua quy trình tự động.
• Trích xuất và cập nhật dữ liệu
  Đọc và ghi dữ liệu lớn từ/đến Google Sheets, lý tưởng cho chuỗi ETL, báo cáo và tự động hóa dashboard.
• Truy cập cộng tác và chia sẻ
  Chia sẻ bảng tính theo lập trình với nhiều người dùng và đặt quyền, hỗ trợ cộng tác nhóm và thông báo tự động.
• Thao tác dữ liệu hàng loạt
  Thực hiện cập nhật hàng loạt, chèn nhiều hàng/cột và áp dụng thay đổi cho sheet lớn một cách hiệu quả, tiết kiệm thời gian cho các tác vụ lặp lại.
• Sao chép và tổ chức sheet
  Sao chép sheet giữa các bảng tính để tạo mẫu, sao lưu hoặc tổ chức quy trình, hỗ trợ mở rộng quy mô cho nhóm.

Cách thiết lập

Windsurf

1. Đảm bảo bạn đã cài đặt Bun (v1.0+) và thiết lập thông tin xác thực Google Cloud (OAuth2 hoặc Tài khoản Dịch vụ).
2. Sao chép kho mã nguồn và cài đặt phụ thuộc:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. Cấu hình biến môi trường như bên dưới.
4. Trong tệp cấu hình Windsurf, thêm máy chủ MCP bằng đoạn JSON.
5. Lưu cấu hình và khởi động lại Windsurf.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Bảo mật API key với biến môi trường:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Claude

1. Cài đặt các điều kiện cần thiết và sao chép kho mã nguồn.
2. Thiết lập xác thực Google Cloud và biến môi trường.
3. Tìm và sửa tệp cấu hình MCP của Claude.
4. Thêm máy chủ Google Sheets MCP với đoạn cấu hình.
5. Khởi động lại Claude và xác minh kết nối.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cursor

1. Đảm bảo đã cài Bun và cấu hình thông tin xác thực.
2. Tải xuống và thiết lập kho mã nguồn.
3. Sửa tệp cấu hình MCP của Cursor.
4. Thêm mục máy chủ Google Sheets MCP.
5. Lưu thay đổi và khởi động lại Cursor để kích hoạt máy chủ.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cline

1. Cài đặt Bun và thiết lập thông tin xác thực dự án Google Cloud.
2. Sao chép kho mã nguồn và cài đặt đầy đủ các phụ thuộc.
3. Truy cập và sửa cấu hình máy chủ MCP của Cline.
4. Đăng ký máy chủ Google Sheets MCP bằng định dạng JSON.
5. Khởi động lại Cline để áp dụng thiết lập.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Bảo mật API key bằng biến môi trường:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Cách sử dụng MCP này trong luồng

Sử dụng MCP trong FlowHunt

Để tích hợp các máy chủ MCP vào quy trình FlowHunt của bạn, hãy bắt đầu bằng cách thêm thành phần MCP vào luồng và kết nối nó với tác nhân AI:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "google-sheets": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI sẽ có thể dùng MCP này như một công cụ với đầy đủ chức năng và khả năng của nó. Hãy nhớ đổi “google-sheets” thành tên thực tế của máy chủ MCP bạn dùng và thay URL thành URL máy chủ MCP của bạn.

Tổng quan

Đánh giá của chúng tôi

Máy chủ MCP này có tài liệu hướng dẫn cài đặt tốt và cung cấp bộ công cụ mạnh mẽ cho tự động hóa Google Sheets. Tuy nhiên, nó thiếu tài liệu về prompt MCP và tài nguyên rõ ràng, cũng như chưa đề cập đến hỗ trợ sampling hoặc roots. Phạm vi công cụ rộng và hướng dẫn bảo mật rõ ràng làm tăng giá trị cho tự động hóa bảng tính, nhưng có thể cải thiện thêm nếu bổ sung tài liệu về prompt/tài nguyên và làm rõ về sampling/roots.

Điểm MCP