1. 服务概述
一句话简介：Google Drive只读SQL查询接口MCP服务器，通过关系型SQL模型暴露Drive数据
- 服务名称：Google Drive MCP Server by CData
- 版本号：1.0
- 开发者/提供方：CDataSoftware
- 协议类型：MCP (Model Context Protocol)
2. 核心功能
列出该MCP服务提供的主要功能点：
- SQL查询接口：通过标准SQL SELECT语句查询Google Drive数据
- 表结构查询：列出数据源中可用的表和列
- 关系型数据模型：将Google Drive数据暴露为关系型SQL模型
- OAuth认证：支持OAuth认证方式连接Google Drive
- 实时数据访问：查询实时的Google Drive数据，无需数据复制
- 自然语言查询：LLM可以通过自然语言问题检索信息，无需SQL知识
3. 使用场景
描述该服务适合在什么情况下使用：
- 数据分析：通过SQL查询分析Google Drive中的文件和文件夹数据
- 文件管理：查询和检索Google Drive中的文件信息
- 报表生成：基于Google Drive数据生成报表和洞察
- 数据探索：使用自然语言探索Google Drive数据结构
- 集成应用：将Google Drive数据集成到AI应用中
- 文档检索：快速查找和检索Google Drive中的文档
4. 接入方式
4.1 服务端点
该服务通过MCP协议提供接口，采用本地托管模式，使用stdio通信。
4.2 认证与权限
服务使用OAuth认证方式连接Google Drive：
- 首次连接时需要在浏览器中进行OAuth认证
- 认证信息会被缓存以便后续使用
- 需要配置正确的JDBC连接字符串
4.3 数据格式
服务使用CSV格式返回查询结果，第一行包含列标题。支持标准SQL SELECT语法。
4.4 服务器配置
创建配置文件（google-drive.prp）：
Prefix=googledrive ServerName=CDataGoogleDrive ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.googledrive.jar DriverClass=cdata.jdbc.googledrive.GoogleDriveDriver JdbcUrl=jdbc:googledrive:InitiateOAuth=GETANDREFRESH; Tables=在Claude Desktop中配置（Windows）：
{ "mcpServers": { "google-drive": { "command": "PATH\\TO\\java.exe", "args": [ "-jar", "PATH\\TO\\CDataMCP-jar-with-dependencies.jar", "PATH\\TO\\google-drive.prp" ] } } }在Claude Desktop中配置（Linux/Mac）：
{ "mcpServers": { "google-drive": { "command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/google-drive.prp" ] } } }5. 接口定义
该服务提供的主要工具接口包括：
5.1 核心工具
| 工具名称 | 功能描述 | 参数说明 |
|---|---|---|
| {servername}_get_tables | 检索数据源中可用的表列表 | 无参数 |
| {servername}_get_columns | 检索表的列列表 | table: 表名 |
| {servername}_run_query | 执行SQL SELECT查询 | sql: SQL查询语句 |
5.2 JSON-RPC请求示例
获取表列表：
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "google_drive_get_tables", "arguments": {} } }获取列信息：
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "google_drive_get_columns", "arguments": { "table": "Account" } } }执行查询：
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "google_drive_run_query", "arguments": { "sql": "SELECT * FROM [Account] WHERE [IsDeleted] = true" } } }6. 快速开始
6.1 环境要求
- Java运行环境
- Maven（用于构建）
- CData JDBC Driver for Google Drive
- CData JDBC Driver许可证（试用或正式）
6.2 示例代码
克隆和构建：
# 克隆仓库 git clone https://github.com/cdatasoftware/google-drive-mcp-server-by-cdata.git cd google-drive-mcp-server-by-cdata # 构建服务器 mvn clean install安装和许可CData JDBC Driver：
# 下载驱动 # https://www.cdata.com/drivers/googledrive/download/jdbc/ # 许可驱动 cd /Applications/CData JDBC Driver for Google Drive/ java -jar cdata.jdbc.googledrive.jar --license # 配置连接 java -jar cdata.jdbc.googledrive.jar运行服务器：
java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/google-drive.prp使用示例：
# 自然语言查询示例 "What is the correlation between my closed won opportunities and the account industry?" "How many open tickets do I have in the SUPPORT project?" "Can you tell me what calendar events I have today?" "Show me all PDF files in my Google Drive"7. 注意事项
重要提示：
- 只读模式：此MCP服务器仅支持读取操作，不支持写入、更新或删除
- 本地部署：服务器使用stdio通信，只能在运行客户端的同一机器上使用
- 许可证要求：需要CData JDBC Driver的有效许可证（试用或正式）
- OAuth认证：首次连接需要在浏览器中完成OAuth认证流程
- 完整功能版本：如需完整的读写功能和简化设置，可使用CData MCP Server for Google Drive
- 远程访问：如需完全远程的MCP访问，可使用CData Connect AI平台
- 配置文件：确保正确配置.prp文件中的所有必需属性
- 驱动路径：DriverPath必须是JAR文件的完整绝对路径
- 客户端重启：配置后可能需要完全退出并重新打开Claude Desktop客户端
- MIT许可证：此MCP服务器采用MIT许可证开源
