Coalesce MCP

整合MCP服务器

一 MCP（模型上下文协议） 服务器，让克劳德直接访问您的 合并 数据管道。让克劳德调查故障，检查节点，并用简单的英语理解你的管道——不要离开你的聊天室。

它做什么

故障调查 --主要用例。问克劳德：

• *“为什么95011失败了？”*
• *“最后一个小时失败了什么？”*
• *“显示故障节点的错误和SQL”*

克劳德会打电话的 investigate_failure，在一个响应中显示确切的错误消息、失败的SQL以及哪些下游节点被阻止。

节点检查 --浏览并阅读您的工作空间：

• *“显示节点X的列和变换”*
• *“这个临时工作台是什么样子的？”*

节点编辑 --以编程方式修改工作区节点（禁用 COALESCE_READONLY_MODE=true):

• *“更新此节点上的SQL”*
• *“创建新阶段节点”*
• *“将TRY_AST修复程序应用于故障列”*

快速开始

1.安装

# Recommended
uvx --from coalesce-mcp coalesce-mcp-server

# Or install globally
uv tool install coalesce-mcp

2.获取您的API代币

1. 登录Coalesce
2. 首选 设置 → API令牌
3. 创建一个令牌并复制它

3.配置克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "coalesce": {
      "command": "uvx",
      "args": ["--from", "coalesce-mcp", "coalesce-mcp-server"],
      "env": {
        "COALESCE_API_TOKEN": "your-token-here"
      }
    }
  }
}

重新启动克劳德桌面。你完了。

工具

故障调查

节点管理

推荐的调查工作流程

1. list_failed_runs          → find a run_id
2. investigate_failure       → root cause + downstream impact
3. get_workspace_node        → inspect the failing node's SQL and transforms
4. patch_node_field          → apply the fix (with your approval)

配置

在联合账户之间切换

切换帐户最简单的方法是更新 COALESCE_API_TOKEN 在你的 .env 文件。

复制 .env.example 到 .env 并填写您的令牌：

cp .env.example .env
# Edit .env and set COALESCE_API_TOKEN to your token

要连接到其他帐户，请替换中的令牌值 .env 使用新帐户的令牌，然后重新启动MCP主机（Claude Desktop或Cortex CLI）。

# .env
COALESCE_API_TOKEN=your-new-account-token-here

永不承诺 .env 到git。 它列在 .gitignore.使用 .env.example 作为参考模板。

雪花皮CLI

将此添加到 ~/.snowflake/cortex/mcp.json，直接粘贴您的令牌：

{
  "mcpServers": {
    "coalesce": {
      "command": "/path/to/coalesce-mcp-server",
      "env": {
        "COALESCE_API_TOKEN": "your-token-here",
        "COALESCE_READONLY_MODE": "true"
      }
    }
  }
}

注： Cortex CLI不扩展shell变量——直接粘贴令牌值，而不是使用 ${COALESCE_API_TOKEN}.

集 COALESCE_READONLY_MODE=true 如果您的代理角色是只读的。

发展

git clone https://github.com/JarredR092699/coalesce-mcp.git
cd coalesce-mcp

# Install with dev dependencies
uv sync

# Run tests
uv run pytest

# Install locally
uv tool install . --force

需求

• Python 3.10+
• 具有API访问权限的联合帐户

许可证

麻省理工学院——见 许可证

链接

• 问题
• 合并API文件
• 模型上下文协议