Gdp MCP Tools

GDP MCP工具

用于Grubhub数据平台操作的MCP（模型上下文协议）服务器。18个服务类别的40多种工具。适用于Claude Code、VS Code、Cursor、JetBrains或任何兼容MCP的客户端。

快速入门（5分钟）

1.克隆并设置虚拟环境

# Ask your team lead for the repo URL, or use:
git clone https://github.com/asuar16/gdp-mcp-tools.git
cd gdp-mcp-tools

# macOS / Linux
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Windows (PowerShell)
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

2.配置凭据

cp .env.example src/.env

编辑 src/.env 凭你的证件。看 凭证 在......下面

3.配置您的MCP客户端

添加 .mcp.json 在 任何回购 您需要这些工具的位置：

macOS/Linux：

{
  "mcpServers": {
    "gdp-tools": {
      "type": "stdio",
      "command": "/absolute/path/to/gdp-mcp-tools/venv/bin/python",
      "args": ["/absolute/path/to/gdp-mcp-tools/src/server.py"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "gdp-tools": {
      "type": "stdio",
      "command": "C:\\path\\to\\gdp-mcp-tools\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\gdp-mcp-tools\\src\\server.py"]
    }
  }
}

4.连接VPN并开始使用

所有工具都需要VPN。先连接，然后使用任何MCP客户端。

______________________________________________________________________

从任何Repo使用

已经建立了gdp mcp工具？以下是如何在1分钟内将其添加到新的仓库中：

第一步：找到你的路

cd ~/path/to/gdp-mcp-tools
echo "Python: $(pwd)/venv/bin/python"
echo "Server: $(pwd)/src/server.py"

第二步：创建 .mcp.json 在您的新仓库中

cd ~/path/to/your-new-repo

cat > .mcp.json  MCP tools appear in Copilot/AI sidebar

Gemini CLI：

cd ~/path/to/your-new-repo
gemini
# Tools auto-load from .gemini/settings.json

反重力：

Open project -> Tools auto-load from mcp_config.json

就是这样 .mcp.json 告诉任何MCP客户端在哪里找到服务器。新仓库中不需要安装——一切都从 gdp-mcp-tools/.

示例：添加到事件集市、ods_data或任何仓库

{
  "mcpServers": {
    "gdp-tools": {
      "type": "stdio",
      "command": "/Users/yourname/gdp-mcp-tools/venv/bin/python",
      "args": ["/Users/yourname/gdp-mcp-tools/src/server.py"]
    }
  }
}

适用于任何回购——事件集市、ods_data，甚至非GDP项目。

______________________________________________________________________

客户端设置

克劳德代码（命令行界面/桌面/网络）

添加 .mcp.json 到您的项目根目录：

{
  "mcpServers": {
    "gdp-tools": {
      "type": "stdio",
      "command": "/absolute/path/to/gdp-mcp-tools/venv/bin/python",
      "args": ["/absolute/path/to/gdp-mcp-tools/src/server.py"]
    }
  }
}

VS代码/光标

添加 .vscode/settings.json:

{
  "mcp.servers": {
    "gdp-tools": {
      "type": "stdio",
      "command": "/absolute/path/to/gdp-mcp-tools/venv/bin/python",
      "args": ["/absolute/path/to/gdp-mcp-tools/src/server.py"]
    }
  }
}

谷歌反重力

添加 ~/.gemini/antigravity/mcp_config.json （或项目级别 .gemini/settings.json):

macOS/Linux：

{
  "mcpServers": {
    "gdp-tools": {
      "command": "/absolute/path/to/gdp-mcp-tools/venv/bin/python",
      "args": ["/absolute/path/to/gdp-mcp-tools/src/server.py"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "gdp-tools": {
      "command": "C:\\path\\to\\gdp-mcp-tools\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\gdp-mcp-tools\\src\\server.py"]
    }
  }
}

要在配置更改后重新加载：使用 管理MCP服务器>查看原始配置 在Antigravity UI中，或重新启动。

Gemini CLI

添加 ~/.gemini/settings.json （全球）或 .gemini/settings.json （项目层面）：

macOS/Linux：

{
  "mcpServers": {
    "gdp-tools": {
      "command": "/absolute/path/to/gdp-mcp-tools/venv/bin/python",
      "args": ["/absolute/path/to/gdp-mcp-tools/src/server.py"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "gdp-tools": {
      "command": "C:\\path\\to\\gdp-mcp-tools\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\gdp-mcp-tools\\src\\server.py"]
    }
  }
}

要重新加载：运行 /mcp reload 在Gemini CLI中，或重新启动。

JetBrains（IntelliJ/PyCharm）

设置>工具>MCP服务器>添加：

• 姓名： gdp-tools
• 命令： /absolute/path/to/gdp-mcp-tools/venv/bin/python
• Args： /absolute/path/to/gdp-mcp-tools/src/server.py

任何MCP客户端（stdio传输）

/path/to/gdp-mcp-tools/venv/bin/python /path/to/gdp-mcp-tools/src/server.py

从stdin读取JSON-RPC，将响应写入stdout，记录到stderr。

______________________________________________________________________

凭证

复制 .env.example 到 src/.env 并填写：

______________________________________________________________________

工具目录

数据平台（13个工具）

可观察性（7个工具）

分析（7个工具）

协作（10个工具）

数据目录（7个工具）

______________________________________________________________________

文件结构

gdp-mcp-tools/
  README.md                 # This file
  TOOLS.md                  # Detailed tool reference
  requirements.txt          # Python dependencies
  .env.example              # Credential template (copy to src/.env)
  .mcp.json.example         # MCP client config template
  .gitignore

  src/
    server.py               # FastMCP entry point (stdio transport)
    auth.py                 # Shared auth (Jenkins, Azkaban, Trino, Jira)
    .env                    # Your credentials (gitignored, never committed)
    tools/
      jenkins_tools.py      # Deploy, sync, integrate, cluster ops
      scheduler_tools.py    # Azkaban flows, monitor, cancel
      trino_tools.py        # SQL queries (dev/preprod/prod)
      emr_tools.py          # EMR cluster list/describe
      s3_tools.py           # S3 partition listing
      backfill_tools.py     # Backfill planning + execution
      sync_plan_tools.py    # Smart sync planning
      spark_tools.py        # Spark History Server
      flowlogs_tools.py     # Azkaban log retrieval via SSH
      pv_tools.py           # PV failure analysis
      vpn_tools.py          # VPN connect/disconnect/status
      jira_tools.py         # Jira issue management
      slack_tools.py        # Slack messaging
      github_tools.py       # GitHub PR operations
      pr_tools.py           # PR discussion threads
      google_doc_tools.py   # Branded Google Doc creation
      datahub_tools.py      # DataHub lineage/search
      redash_tools.py       # Redash query/viz management

  scripts/                  # Utility scripts (not MCP tools)
    datadog_wrapper.sh      # DataDog MCP wrapper
    pagerduty_wrapper.sh    # PagerDuty MCP wrapper
    google_workspace_wrapper.sh
    create_redash_queries.py

  config/
    config.json             # Tool configuration

______________________________________________________________________

故障排除