关于 datatomcp
datatomcp 是托管的表格数据 MCP 服务,供 Agent 查询 CSV 和 Google Sheets。它通过 DuckDB 计算筛选、分组和汇总结果,并提供只读访问与数据导入报告。
主要功能
- 01查询 CSV 和 Google Sheets
- 02筛选、排序与分页行记录
- 03按列分组并计算汇总指标
- 04检查列类型及导入警告
- 05OAuth 授权与只读访问
适用场景
- 01核对销售数据的数量与收入
- 02按地区或日期筛选表格记录
- 03汇总 Google Sheets 中的分类数据
MCP 相关
提供基于 Streamable HTTP 的远程 MCP 服务,使用 OAuth 2.1 授权。客户端可调用工具发现数据集、查询行记录并执行聚合。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
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 转换为远程 MCP 服务,供 AI Agent 查询。
datatomcp 是一个用于表格数据的托管 MCP 服务。上传 CSV、粘贴 CSV 链接,或选择 Google Sheet。随后,你的 Agent(Claude、ChatGPT、Cursor 等)便可筛选、分组并汇总行数据。数值由数据库计算得出,而非由模型估算。
- 托管服务。 无需安装或运行任何内容。一个 URL 即可用于所有支持远程 MCP 服务的客户端。
- OAuth 登录。 无需将 API 密钥粘贴到 Agent 中。你可以随时撤销访问权限。
- 精确结果。 计数、求和与平均值由 DuckDB 得出。每项结果都会注明其所依据的数据集版本。
- 私有 Google Sheets。 你可以在 Google 文件选择器中选择工作表,datatomcp 只能读取该文件。Pro 会每小时同步一次。
- 导入报告。 在任何 Agent 查看数据前,系统会报告错误行、以文本形式存储的数字以及混合日期格式。
- 只读。 Agent 可以查询你的数据,但无法修改数据或运行原始 SQL。
- 托管于欧盟。 你的数据绝不会发送给 AI 提供商,也不会用于训练。
此仓库包含公开文档和客户端配置。服务本身运行于 app.datatomcp.com。
服务
| URL | https://app.datatomcp.com/mcp |
| 传输方式 | Streamable HTTP |
| 身份验证 | OAuth 2.1(动态客户端注册和客户端 ID 元数据文档) |
| Registry 名称 | com.datatomcp/datatomcp |
快速开始
- 在 app.datatomcp.com 注册(免费,无需银行卡)。
- 添加数据集:上传 CSV、粘贴链接,或选择 Google Sheet。
- 将服务添加到客户端(见下文),按提示登录,然后询问有关数据的问题。
工具
| 工具 | 功能 |
|---|---|
list_datasets | 列出你的数据集及其行数和最新程度 |
describe_dataset | 查看列、类型、示例值、数据警告和当天日期 |
query_rows | 筛选、排序、选择列并分页(每次最多 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 月有多少订单来自法国?收入是多少?
Agent 会调用 describe_dataset 了解列,然后调用一次 aggregate:
{
"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
同样的数据集也可通过 API 密钥使用 REST 访问,适用于 n8n 或 Make 等应用和自动化流程。请参阅 CSV to REST API。
方案
| 免费版 | 专业版(每月 $12 或 €12) | |
|---|---|---|
| 数据集 | 3 | 25 |
| 每个数据集的行数 | 100,000 | 2,000,000 |
| 每日查询次数 | 1,000 | 50,000 |
| Google Sheets 同步 | 按需 | 每小时 |
指南
支持
如有疑问、错误,或文件未按预期导入,请发送邮件至 [email protected],或在此代码库中提交问题。
许可证
此代码库中的文档和配置采用 MIT 许可证。datatomcp 服务为专有服务。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。