datatomcp について
datatomcpは、CSVやGoogle Sheetsの表データをAgentから照会できるホスト型MCPサーバーです。DuckDBでフィルターや集計を計算し、読み取り専用アクセスとインポート診断を提供します。
主な機能
- 01CSVとGoogle Sheetsの照会
- 02行のフィルター、並べ替え、ページ分割
- 03列ごとのグループ化と集計
- 04列型とインポート警告の確認
- 05OAuth認証による読み取り専用アクセス
活用シーン
- 01売上件数と収益の確認
- 02地域や日付による行の絞り込み
- 03Google Sheetsのカテゴリ集計
MCP 対応
Streamable HTTPとOAuth 2.1を使うリモートMCPサーバーを提供します。クライアントはツールを通じてデータセットの確認、行の照会、集計を行えます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://app.datatomcp.com/mcpclaude mcp add --transport http com-datatomcp-datatomcp https://app.datatomcp.com/mcp{"mcpServers":{"com-datatomcp-datatomcp":{"type":"http","url":"https://app.datatomcp.com/mcp"}}}Cursor で開く{"servers":{"com-datatomcp-datatomcp":{"type":"http","url":"https://app.datatomcp.com/mcp"}}}VS Code で開く{"mcpServers":{"com-datatomcp-datatomcp":{"type":"http","url":"https://app.datatomcp.com/mcp"}}}{"mcpServers":{"com-datatomcp-datatomcp":{"serverUrl":"https://app.datatomcp.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
CSV または Google Sheet を、AI エージェントがクエリできるリモート MCP サーバーに変換します。
datatomcp は、表形式データ用のホスト型 MCP サーバーです。CSV をアップロードするか、CSV のリンクを貼り付けるか、Google Sheet を選択します。エージェント(Claude、ChatGPT、Cursor など)は、行をフィルタリング、グループ化し、合計を計算できます。数値はモデルが推定するのではなく、データベースが計算します。
- ホスト型。 インストールも実行も不要です。リモート MCP サーバーに対応するすべてのクライアントで、1 つの URL を使用できます。
- OAuth サインイン。 エージェントに API キーを貼り付ける必要はありません。いつでもアクセスを取り消せます。
- 正確な結果。 件数、合計、平均は DuckDB によって計算されます。各結果には、どのバージョンのデータセットに基づくかが示されます。
- 非公開の Google Sheets。 Google のファイル選択画面でシートを選ぶと、datatomcp はそのファイルだけを読み取れます。Pro では毎時同期されます。
- インポートレポート。 不正な行、テキストとして保存された数値、形式が混在する日付は、エージェントがデータを見る前に報告されます。
- 読み取り専用。 エージェントはデータをクエリできますが、変更したり、生の SQL を実行したりすることはできません。
- EU でホスト。 データが AI プロバイダーに送信されたり、トレーニングに使用されたりすることはありません。
このリポジトリには、公開ドキュメントとクライアント設定が含まれています。サービス自体は app.datatomcp.com で実行されています。
サーバー
| URL | https://app.datatomcp.com/mcp |
| トランスポート | Streamable HTTP |
| 認証 | OAuth 2.1(動的クライアント登録とクライアント ID メタデータドキュメント) |
| レジストリ名 | com.datatomcp/datatomcp |
クイックスタート
- app.datatomcp.com で登録します(無料、カード不要)。
- データセットを追加します。CSV をアップロードするか、リンクを貼り付けるか、Google Sheet を選択します。
- サーバーをクライアントに追加し(以下を参照)、求められたらサインインして、データについて質問します。
ツール
| ツール | 機能 |
|---|---|
list_datasets | 行数と最新状態を含む、ユーザーのデータセット一覧 |
describe_dataset | 列、型、値の例、データに関する警告、今日の日付 |
query_rows | フィルタリング、並べ替え、列の選択、ページ分割(1 回の呼び出しにつき最大 1,000 行) |
aggregate | 列ごとにグループ化し、件数、ユニーク件数、合計、平均、最小値、最大値を計算 |
distinct_values | フィルターを正確に一致させるための、列の実際の値 |
フィルターは eq、neq、gt、gte、lt、lte、in、not_in、contains、starts_with、between、is_null、not_null に対応しています。
クライアントのセットアップ
Claude(Claude.ai および Claude Desktop)
設定 → コネクター → カスタムコネクターを追加 を選択します。https://app.datatomcp.com/mcp を貼り付け、名前を datatomcp にして接続し、アクセスを許可します。
Claude Code
claude mcp add --transport http datatomcp https://app.datatomcp.com/mcp
次に /mcp を実行し、datatomcp を選択してサインインします。
ChatGPT
設定 → アプリとコネクター → 詳細設定を開き、開発者モードをオンにします。上記の URL と OAuth 認証を使用してコネクターを作成し、サインインします。
Cursor
設定 → MCP → 新しいサーバーを追加 を選択します。種類に HTTP を選び、上記の URL を使用します。初回に Cursor からログインを求められます。
VS Code
.vscode/mcp.json:
{
"servers": {
"datatomcp": { "type": "http", "url": "https://app.datatomcp.com/mcp" }
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"datatomcp": { "serverUrl": "https://app.datatomcp.com/mcp" }
}
}
Cline
MCP サーバーパネル → リモートサーバー を開き、名前を datatomcp にして、上記の URL を使用します。または、cline_mcp_settings.json に追加します。
{
"mcpServers": {
"datatomcp": { "type": "streamableHttp", "url": "https://app.datatomcp.com/mcp" }
}
}
Antigravity
カスタマイズ → MCP サーバー → 生の設定を表示(mcp_config.json):
{
"mcpServers": {
"datatomcp": { "serverUrl": "https://app.datatomcp.com/mcp" }
}
}
更新をクリックしてから、認証します。
OpenCode
opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"datatomcp": { "type": "remote", "url": "https://app.datatomcp.com/mcp" }
}
}
Codex
codex mcp add datatomcp --url https://app.datatomcp.com/mcp
codex mcp login datatomcp
Gemini CLI
gemini mcp add --transport http datatomcp https://app.datatomcp.com/mcp
次に /mcp auth datatomcp を実行します。
ローカル(stdio)サーバーのみを使用するクライアント
ブリッジとして mcp-remote を使用します。サインインはこれが処理します。
{
"mcpServers": {
"datatomcp": { "command": "npx", "args": ["-y", "mcp-remote", "https://app.datatomcp.com/mcp"] }
}
}
例
9月にフランスから来た注文数と売上はいくらですか?
エージェントは列を確認するために describe_dataset を呼び出し、その後 aggregate を1回呼び出します。
{
"dataset_id": "ds_orders",
"where": [
{ "column": "country", "op": "eq", "value": "France" },
{ "column": "order_date", "op": "between", "value": ["2026-09-01", "2026-09-30"] }
],
"metrics": [
{ "fn": "count", "as": "orders" },
{ "fn": "sum", "column": "total", "as": "revenue" }
]
}
50,000行のテストシートでは、277件の注文と€50,279.50の売上という回答が得られます。ツールの結果はシート全体ではなく、32バイトです。
REST API
同じデータセットは、n8nやMakeなどのアプリや自動化向けに、APIキーを使ってREST経由でも利用できます。CSV to REST APIをご覧ください。
プラン
| Free | Pro(月額$12または€12) | |
|---|---|---|
| データセット | 3 | 25 |
| データセットあたりの行数 | 100,000 | 2,000,000 |
| 1日あたりのクエリ数 | 1,000 | 50,000 |
| Google Sheetsの同期 | オンデマンド | 毎時 |
ガイド
サポート
ご質問、バグ、または想定どおりにインポートされないファイルがある場合は、[email protected]までご連絡いただくか、このリポジトリでイシューを作成してください。
ライセンス
このリポジトリのドキュメントと設定はMITライセンスです。datatomcpサービスはプロプライエタリです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。