Google Drive MCP MCP 服务说明文档

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.prpPrefixgoogledrive ServerNameCDataGoogleDrive ServerVersion1.0 DriverPathPATH\TO\cdata.jdbc.googledrive.jar DriverClasscdata.jdbc.googledrive.GoogleDriveDriver JdbcUrljdbc:googledrive:InitiateOAuthGETANDREFRESH; 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 DriveCData 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 Drive7. 注意事项重要提示只读模式此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许可证开源