mcpField
S
sheetport

sheetport

ローカル
github.com/CloudCorpRecordsデータ・分析02 週間前に更新
リポジトリ

sheetport について

sheetportは、Google Sheets API v4を通じてスプレッドシート、セルの値、基本的なシート操作を行うMCPサーバーです。Google OAuthアクセストークンを使うMCPクライアント向けに、主要な操作を提供します。

主な機能

  1. 01スプレッドシートの読み取りと作成
  2. 02セル値の読み取り、更新、追加、消去
  3. 03セル値の一括更新
  4. 04シートの追加、コピー、名前変更

活用シーン

  1. 01MCPクライアントからの表データ確認
  2. 02セル範囲の更新や値の追加
  3. 03基本的なシートの作成と整理

MCP 対応

スプレッドシートとセル値を操作するツールをMCPクライアントに公開します。stdioのMCPサーバーとして起動し、Google OAuthアクセストークンを指定します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "cloudcorprecords-sheetport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/sheetport"
      ]
    }
  }
}
起動コマンドnpx -y @reneturcios/sheetport

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@reneturcios/sheetport0.1.0
ocighcr.io/cloudcorprecords/sheetport:0.1.0

ツール

10

掲載時のツール一覧 · 1 週間前に更新

パラメーター型必須説明
spreadsheet_idstringはい取得するスプレッドシートの一意の識別子。

詳細

sheetport

Google Sheets のスプレッドシートとセルの値を MCP ツールとして扱い、 Google Sheets API v4 と通信します。sheetport は、Google Sheets MCP のコア部分を新しい名前でクリーンルーム再構築したものです。スプレッドシートと値の操作に加え、基本的なシート管理に対応しており、コードは新規作成で、ブランドをコピーしていません。

ツール（コア部分、10 個）

get_spreadsheet、create_spreadsheet、get_values、update_values、 append_values、clear_values、batch_update_values、add_sheet、 copy_sheet、rename_sheet。

書式設定、グラフ、ピボットテーブル、条件付き書式、デベロッパー メタデータ、保護された範囲、名前付き範囲、スプレッドシート全般の batchUpdate パススルー、Drive ファイル操作は、この対象に含まれません。

セットアップ

Google OAuth アクセストークンを設定します。

export GOOGLE_ACCESS_TOKEN=ya29....

必要に応じて、SHEETS_API_URL で API のベース URL を上書きできます （デフォルトは https://sheets.googleapis.com/v4 です）。トークンがない場合、 すべてのツール呼び出しは、不足している変数の名前を示すエラーで失敗します。

CLI

npx @reneturcios/sheetport get_values '{"spreadsheet_id":"abc","range":"Sheet1!A1:B2"}'
npx @reneturcios/sheetport mcp        # stdio MCP server

各ツール名は、1 つの JSON オブジェクト引数を受け取るサブコマンドです。

MCP クライアントの設定

{
  "mcpServers": {
    "sheetport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/sheetport", "mcp"],
      "env": { "GOOGLE_ACCESS_TOKEN": "ya29...." }
    }
  }
}

Docker

docker run -i -e GOOGLE_ACCESS_TOKEN ghcr.io/cloudcorprecords/sheetport

開発

npm install
npm run build
npm test

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。