AI导哈

数据管道分析工具

Coalesce MCP Server 是一个模型上下文协议服务器，允许Claude直接访问Coalesce数据管道，进行故障调查、节点检查和编辑，无需离开聊天界面。

  • by JarredR092699
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 JarredR092699/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"
      }
    }
  }
}

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

工具

故障调查

工具 说明
investigate_failure 最佳起点。 在一次调用中运行元数据+失败节点（带有错误消息和SQL）+下游阻塞节点。
list_failed_runs 列出最近失败的运行。使用此功能查找 run_id 调查。
list_job_runs 列出所有最近运行的可选筛选器（状态、环境、限制）。
get_run_results 运行的节点级结果——仅失败和阻塞节点，成功节点省略。
get_run 特定运行的完整元数据。
get_run_status 通过调度程序端点查看实时状态。
get_job_details 运行元数据+提取的错误组合。

节点管理

工具 说明
list_workspace_nodes 列出工作区中的所有节点。
list_environment_nodes 列出环境中所有已部署的节点。
get_workspace_node 完整节点配置——列、转换、源映射、SQL。
get_environment_node 与上述部署（生产）节点相同。
create_workspace_node 使用默认值创建新节点。
set_node 现有节点的完全替换更新。 先读，再写。
patch_node_field 手术单场更新（例如修复一列变换）。内部处理获取、修改、替换。

推荐的调查工作流程

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 必需 来自Coalesce设置的承载令牌→ API令牌
COALESCE_BASE_URL https://app.coalescesoftware.io/api/ 覆盖本地部署
COALESCE_READONLY_MODE false 设置 true 隐藏 create_workspace_node, set_node，以及 patch_node_field

在联合账户之间切换

切换帐户最简单的方法是更新 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访问权限的联合帐户

许可证

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

链接

相关 MCP