Grist MCP Server

🚀 Grist MCP Server

Grist用のMCPサーバーです。ドキュメント、レコード、SQL、ページに関する11のツールが用意されています。

🚀 クイックスタート

Claude Code (推奨)

claude mcp add grist --env GRIST_API_KEY=your_api_key --env GRIST_BASE_URL=https://docs.getgrist.com -- npx -y grist-mcp-server

Claude Desktop (MCPBバンドル)

1. Releases から grist-mcp-server.mcpb をダウンロードします。
2. Claude Desktopで、設定 → 開発者 → MCPサーバー → MCPBからインストール を選択します。
3. GristのAPIキーとベースURLを設定します。
4. Claude Desktopを再起動します。

手動設定 (.mcp.json)

.mcp.json ファイルに以下を追加します。

{
  "mcpServers": {
    "grist": {
      "command": "npx",
      "args": ["-y", "grist-mcp-server"],
      "env": {
        "GRIST_API_KEY": "your_api_key",
        "GRIST_BASE_URL": "https://docs.getgrist.com"
      }
    }
  }
}

ソースからインストール

git clone https://github.com/gwhthompson/grist-mcp-server.git
cd grist-mcp-server
npm install && npm run build

MCP設定に以下を追加します。

{
  "mcpServers": {
    "grist": {
      "command": "node",
      "args": ["/path/to/grist-mcp-server/dist/index.js"],
      "env": {
        "GRIST_API_KEY": "your_api_key",
        "GRIST_BASE_URL": "https://docs.getgrist.com"
      }
    }
  }
}

✨ 主な機能

💻 使用例

データベースの作成

1. grist_get_workspaces → ワークスペースを検索
2. grist_create_document → ドキュメントを作成
3. grist_manage_schema → 列を持つテーブルを作成

データのインポート

1. grist_get_documents → ドキュメントを検索
2. grist_get_tables → 構造を確認
3. grist_manage_records → データをアップサート（新規追加、既存の更新）

データのクエリ

1. grist_get_tables → スキーマを理解
2. grist_query_sql → JOINや集計を含むSQLを実行

🔧 トラブルシューティング

サーバーが起動しない場合：設定で GRIST_API_KEY が設定されていることを確認してください。

認証に失敗する場合：https://docs.getgrist.com/settings/keys でAPIキーを確認してください。

ドキュメントリストが空の場合：GRIST_BASE_URL があなたのGristインスタンスと一致していることを確認してください。

接続エラー（セルフホスト）の場合：URLに https:// が含まれており、サーバーにアクセス可能であることを確認してください。

🧪 テスト

npm test  # Dockerが必要 - コンテナのライフサイクルは自動で管理されます

📚 ドキュメント

ツールの説明は簡潔です。詳細は grist_help を使用してください。

• grist_help({tools: ["grist_manage_records"], only: ["examples"]})
• grist_help({tools: ["grist_query_sql"], only: ["errors"]})

バージョン履歴については CHANGELOG.md をご覧ください。

🔗 リンク

• Grist Documentation
• Grist Community
• MCP Protocol
• Report Issues