dagster-mono-mcp
dagster-mono-mcp
Dagster를 위한 단일 도구 MCP 서버입니다. 하나의 도구, 다섯 가지 작업, 최소한의 토큰 오버헤드를 제공합니다.
Dagster에는 공식 MCP 서버가 있지만, 쉽게 작동하게 만들기가 어려웠습니다. 이 서버는 LLM으로 파이프라인을 디버깅할 때 실제로 필요한 작업인 실행 목록 확인, 실행 세부 정보 검사, 로그 읽기, 그리고 기타 모든 작업을 위한 원시 GraphQL 쿼리를 수행할 수 있는 최소한의 대안입니다.
Zero Trust 뒤에 있는 Dagster 인스턴스를 위해 Cloudflare Access를 지원하며, 이는 Dagster 인스턴스를 보호하는 쉽고 무료인 방법입니다.
설치
Claude Code
프로젝트 범위 지정 (.mcp.json을 프로젝트 루트에 생성):
{
"mcpServers": {
"dagster": {
"command": "npx",
"args": ["-y", "github:pjatx/dagster-mono-mcp"],
"env": {
"DAGSTER_GRAPHQL_URL": "https://dagster.example.com/graphql",
"CF_ACCESS_CLIENT_ID": "your-client-id",
"CF_ACCESS_CLIENT_SECRET": "your-client-secret"
}
}
}
}전역 설정 (~/.claude.json — 모든 프로젝트에서 사용 가능):
{
"mcpServers": {
"dagster": {
"command": "npx",
"args": ["-y", "github:pjatx/dagster-mono-mcp"],
"env": {
"DAGSTER_GRAPHQL_URL": "https://dagster.example.com/graphql"
}
}
}
}Cursor
프로젝트 루트의 .cursor/mcp.json에 추가:
{
"mcpServers": {
"dagster": {
"command": "npx",
"args": ["-y", "github:pjatx/dagster-mono-mcp"],
"env": {
"DAGSTER_GRAPHQL_URL": "https://dagster.example.com/graphql",
"CF_ACCESS_CLIENT_ID": "your-client-id",
"CF_ACCESS_CLIENT_SECRET": "your-client-secret"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json에 추가:
{
"mcpServers": {
"dagster": {
"command": "npx",
"args": ["-y", "github:pjatx/dagster-mono-mcp"],
"env": {
"DAGSTER_GRAPHQL_URL": "https://dagster.example.com/graphql",
"CF_ACCESS_CLIENT_ID": "your-client-id",
"CF_ACCESS_CLIENT_SECRET": "your-client-secret"
}
}
}
}Related MCP server: MCP Access OAuth Server
환경 변수
변수 | 기본값 | 필수 여부 |
|
| 아니요 |
| — | 아니요 (CF Access 뒤에 있는 경우 필수) |
| — | 아니요 (CF Access 뒤에 있는 경우 필수) |
사용법
작업 디스패치를 포함하는 단일 도구 dagster:
실행 목록 확인
{"action": "runs"}
{"action": "runs", "status": "FAILURE"}
{"action": "runs", "job": "my_job", "limit": 5}실행 세부 정보
{"action": "run", "id": "<run-id>"}이벤트 로그
{"action": "logs", "id": "<run-id>"}
{"action": "logs", "id": "<run-id>", "limit": 100}원시 GraphQL
{"action": "graphql", "query": "{ version }"}
{"action": "graphql", "query": "query($id: ID!) { runOrError(runId: $id) { __typename } }", "variables": {"id": "abc123"}}도움말
{"action": "help"}사용 가능한 상태, 모든 매개변수, 예제 쿼리를 포함한 전체 문서를 반환합니다.
설계
이 프로젝트는 모노 도구(mono-tool) 패턴을 따릅니다. 여러 개의 작은 도구 대신 작업 디스패치를 사용하는 하나의 MCP 도구를 제공합니다. 도구 수가 적으면 LLM의 토큰 오버헤드가 줄어들고 도구 선택이 더 간단해집니다. 모델이 비슷하게 들리는 수십 개의 도구 중에서 고민할 필요가 없습니다. LLM이 MCP 서버와 상호작용하는 방식을 재고한 Cloudflare의 Code Mode 게시물에서 영감을 받았습니다.
개발
npm install
npm run build # esbuild bundle -> dist/index.js
npm start # run the MCP server (stdio transport)라이선스
MIT
Available Tools
1 tooldagsterC
Dagster runs & debugging. Actions: runs, run, logs, graphql, help
{"action": "runs"} -> recent runs {"action": "runs", "status": "FAILURE"} -> failed runs {"action": "run", "id": "abc123"} -> run details {"action": "logs", "id": "abc123"} -> run logs {"action": "graphql", "query": "{ version }"} -> raw GraphQL {"action": "help"} -> full documentation
Inputs: action (required), id, job, status, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
The single tool 'dagster' has clearly distinct actions (runs, run, logs, graphql, help) with no overlap in purpose. Each action targets a specific operation within the Dagster domain, making misselection impossible.
The tool naming is perfectly consistent as there is only one tool, 'dagster', and its actions follow a clear, uniform pattern (e.g., 'runs', 'run', 'logs') without any mixing of conventions or styles.
With only one tool, the server feels thin for a Dagster monitoring/debugging domain, as it bundles multiple distinct operations (e.g., querying runs, fetching logs, GraphQL) into a single tool. This may limit clarity and usability compared to a more granular tool set.
The tool covers core operations like retrieving runs, logs, and GraphQL queries, but lacks obvious lifecycle actions such as triggering new runs, pausing/resuming, or managing assets. This creates notable gaps for a full Dagster debugging workflow.
Maintenance
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Zero-dependency Cloudflare Worker gateway turning websites and REST APIs into MCP tools.
Cloudflare Workers MCP server: ai-cost-optimizer
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceA Cloudflare Workers-based MCP server that enables deployment of custom tools accessible via the Model Context Protocol without authentication requirements.-
- FlicenseNot gradedqualityCmaintenanceA Cloudflare Workers-based MCP server that enables secure remote connections using built-in OAuth authentication via Cloudflare Access. It provides identity-based access control for MCP tools and supports persistent state management through Durable Objects and SSE.-
- FlicenseNot gradedqualityDmaintenanceRemote MCP server with built-in OAuth authentication via Cloudflare Access, enabling secure tool invocation after user sign-in.-
- FlicenseNot gradedqualityNot gradedmaintenanceThis is an MCP server deployed on Cloudflare Workers with OAuth authentication, enabling remote MCP clients to connect and use tools.-