CloudQuery MCP服务器
提供对CloudQuery资产清单数据访问的模型上下文协议（MCP）服务器。
先决条件
- Claude Desktop、Cursor IDE或任何其他能够使用MCP服务器的工具。
- 如果您针对CloudQuery平台、未过期的CloudQuery平台API密钥及其有效部署的URL使用它。
- 如果你在PostgreSQL目标上使用它（来自一个或多个CloudQuery同步），PostgreSQL连接字符串。
安装
来自MCP注册表（推荐）
CloudQuery MCP服务器可通过官方的MCP注册表获得。这是安装和使用服务器的推荐方法。
对于Claude Desktop用户：
- 打开克劳德桌面
- 前往设置→ MCP服务器
- 使用标识符添加新服务器：
io.github.cloudquery/mcp - 为您的用例配置适当的环境变量（请参阅下面的配置部分）
对于其他MCP客户端： 使用服务器标识符 io.github.cloudquery/mcp 从MCP注册表安装。
下载二进制文件
从以下网址下载适用于您平台的最新二进制文件 发布页面.
macOS安全说明
在macOS上，首次运行二进制文件时可能会遇到安全警告。这是因为二进制文件没有使用Apple Developer证书签名。要绕过此问题：
选项1（推荐）：使用命令行删除隔离属性：
xattr -d com.apple.quarantine /path/to/cq-platform-mcp选项2：前往“系统偏好设置”>“安全与隐私”>“常规”，然后单击被阻止应用程序的“无论如何允许”。
支持的模式
MCP服务器支持四种模式：
cli-用于开始使用CloudQuery CLI并使用自然语言生成配置文件postgres-对于同步到PostgreSQL目标的CLI用户，使用自然语言查询同步到数据库的数据snowflake-对于同步到Snowflake目标的CLI用户，使用自然语言查询同步到数据库的数据platform-让CloudQuery Platform客户使用自然语言查询同步到平台的数据
命令行接口命令模式
如果没有设置环境变量，MCP服务器将默认为CLI模式。
PostgreSQL模式
配置以下环境变量以启用PostgreSQL模式。
POSTGRES_CONNECTION_STRING-postgres://user:password@host:port/database
注： 如果不search_path如果在连接字符串中指定，MCP服务器将自动默认为public模式。您可以通过显式设置来覆盖此设置search_path在您的连接字符串中（例如。，postgres://user:password@host:port/database?search_path=myschema或host=localhost dbname=mydb search_path=myschema).
Kerberos认证
对于Kerberos/GSSAPI身份验证，请在连接字符串中包含相应的参数：
postgres://username@REALM.EXAMPLE.COM@host:port/database?krbsrvname=postgrespostgres://username@host:port/database?krbsrvname=postgres&gsslib=gssapi
MCP服务器支持读取 .env 文件夹。雪花模式
配置以下环境变量以启用雪花模式。
SNOWFLAKE_CONNECTION_STRING-雪花连接字符串的格式为：user:password@account/database/schema?warehouse=warehouse_name
连接字符串示例：
user:password@account/database/schema-基本身份验证user:password@account/database/schema?warehouse=COMPUTE_WH-指定仓库user:password@account.region/database/schema?warehouse=COMPUTE_WH-随着地区
有关更多连接字符串选项，请参阅 Snowflake Go驱动程序文档.
MCP服务器支持读取 .env 文件夹。平台模式
配置以下环境变量以启用平台模式。
CQ_PLATFORM_API_URL-https://your-deployment.cloudquery.io/apiCQ_PLATFORM_API_KEY-您的CloudQuery平台API密钥
MCP服务器支持读取 .env 文件夹。可选环境变量
CQAPI_LOG_LEVEL-日志级别：调试、信息、警告、错误（默认值：info)LOG_PRETTY-启用漂亮的控制台日志记录（默认：基于TTY自动检测）LOG_COLOR-启用彩色日志记录（默认：基于TTY自动检测）
Claude桌面集成
通过在以下位置编辑配置文件来配置Claude Desktop $HOME/Library/Application\ Support/Claude/claude_desktop_config.json 在MacOS或 $HOME/.config/Claude/claude_desktop_config.json 在Linux上：
如果您在CloudQuery平台上使用它：
{
"mcpServers": {
"cloudquery": {
"command": "/absolute/path/to/cq-platform-mcp",
"args": [],
"env": {
"CQ_PLATFORM_API_KEY": "your_api_key_here",
"CQ_PLATFORM_API_URL": "https://your-instance.cloudquery.io/api"
}
}
}
}如果你在PostgreSQL目标上使用它，例如：
{
"mcpServers": {
"cloudquery": {
"command": "/absolute/path/to/cq-platform-mcp",
"args": [],
"env": {
"POSTGRES_CONNECTION_STRING": "postgres://user:password@localhost:5432/database?sslmode=disable"
}
}
}
}如果您将其用于Snowflake目的地，例如：
{
"mcpServers": {
"cloudquery": {
"command": "/absolute/path/to/cq-platform-mcp",
"args": [],
"env": {
"SNOWFLAKE_CONNECTION_STRING": "user:password@account/database/schema?warehouse=COMPUTE_WH"
}
}
}
}笔记：
- “command”必须是本地cq平台mcp二进制文件的绝对路径。
示例：“/home/username/cq平台mcp”或“/Users/username/cq平台mcp”
游标IDE集成
通过将MCP服务器配置添加到您的设置中来配置Cursor IDE：
- 打开光标IDE
- 首选 设置 > 光标设置 > 工具和集成
- 添加具有以下配置的新MCP服务器：
{
"mcpServers": {
"cloudquery": {
"command": "/path/to/mcp/binary",
"args": [],
"env": {
"CQ_PLATFORM_API_KEY": "your_api_key_here",
"CQ_PLATFORM_API_URL": "https://your-instance.cloudquery.io/api"
}
}
}
}如果你在PostgreSQL目标上使用它，例如：
{
"mcpServers": {
"cloudquery": {
"command": "/path/to/mcp/binary",
"args": [],
"env": {
"POSTGRES_CONNECTION_STRING": "postgres://user:password@localhost:5432/database?sslmode=disable"
}
}
}
}如果您将其用于Snowflake目的地，例如：
{
"mcpServers": {
"cloudquery": {
"command": "/path/to/mcp/binary",
"args": [],
"env": {
"SNOWFLAKE_CONNECTION_STRING": "user:password@account/database/schema?warehouse=COMPUTE_WH"
}
}
}
}VSCode IDE集成
有多种方法可以在VSCode中集成MCP服务器，如 VSCode MCP文档. 在VSCode中集成CloudQuery MCP服务器的步骤总结如下：
- 打开VSCode IDE
- 首选
MCP: Open User Configuration（也可以在工作区或文件夹级别通过键盘快捷键完成）Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac） - 添加具有以下配置的新MCP服务器：
如果您在CloudQuery平台上使用它：
{
"inputs":[
{
"type":"promptString",
"id":"cloudquery-platform-api-key",
"description":"CloudQuery Platform API Key",
"password":true
},
{
"type":"promptString",
"id":"cloudquery-platform-api-url",
"description":"CloudQuery Platform API URL",
"password":false
}
],
"servers":{
"CloudQuery":{
"type":"stdio",
"command":"/path/to/mcp/binary",
"env":{
"CQ_PLATFORM_API_KEY": "${input:cloudquery-platform-api-key}",
"CQ_PLATFORM_API_URL": "${input:cloudquery-platform-api-url}"
}
}
}
}如果你在PostgreSQL目标上使用它，例如：
{
"inputs":[
{
"type":"promptString",
"id":"cloudquery-postgres-connection-string",
"description":"CloudQuery Postgres Connection String",
"password":true
}
],
"servers":{
"CloudQuery":{
"type":"stdio",
"command":"/path/to/mcp/binary",
"env":{
"POSTGRES_CONNECTION_STRING": "${input:cloudquery-postgres-connection-string}"
}
}
}
}如果您将其用于Snowflake目的地，例如：
{
"inputs":[
{
"type":"promptString",
"id":"cloudquery-snowflake-connection-string",
"description":"CloudQuery Snowflake Connection String",
"password":true
}
],
"servers":{
"CloudQuery":{
"type":"stdio",
"command":"/path/to/mcp/binary",
"env":{
"SNOWFLAKE_CONNECTION_STRING": "${input:cloudquery-snowflake-connection-string}"
}
}
}
}要在列表中看到新的MCP服务器，您可能需要重新启动VSCode。
首次使用时，系统将提示您输入API键和API URL，或PostgreSQL连接字符串。
流式HTTP服务器
MCP服务器也可以作为Streamable HTTP服务器运行，这允许您远程连接到它。为了实现这一点， 设置 HTTP_ADDRESS 将环境变量转换为所需的地址和端口，例如：
export HTTP_ADDRESS=":8080"然后，服务器将侦听路径下传入的HTTP请求 /mcp 在指定的地址和端口上。