이 저장소에는 DBOS 워크플로우를 분석하고 관리할 수 있는 도구가 있는 Model Context Protocol (MCP) 서버가 포함되어 있습니다. LLM을 사용하여 애플리케이션 워크플로 및 단계에 대한 정보를 검색할 수 있습니다. 예를 들어 개발 또는 생산에서 문제를 디버그할 수 있습니다. 이 서버를 사용하려면 애플리케이션이 지휘자에 연결되어야 합니다.

DBOS 프롬프트 (Python, TypeScript, Go, Java)와 함께 사용하기를 원할 수 있습니다.

설치

설치 uv

이 MCP 서버를 사용하기 전에 uv]를 설치해야합니다. 설치 지침은 uv 설치 docs를 참조하십시오.

Claude 코드 설정

Claude Code로 MCP 서버를 사용하려면 먼저 설치하십시오.

그런 다음 Claude Code를 시작하고 DBOS 앱에 대한 질문을하십시오! Claude는 브라우저에서 제공하는 URL을 클릭하여 로그인할 수 있습니다.

Credentials는 ~/.dbos-mcp/credentials에 저장됩니다.

도구

신청 소개

• list_applications - 모든 응용 프로그램 목록
• list_executors - 응용 프로그램에 대한 연결 실행자 목록

Workflow 소개

• list_workflows - 목록/필터 워크플로우

DBOS MCP Server

This repository contains a Model Context Protocol (MCP) server with tools that can analyze and manage your DBOS workflows. It enables LLMs to retrieve information on your applications’ workflows and steps, for example to help you debug issues in development or production. To use this server, your application should be connected to Conductor.

You may want to use this alongside a DBOS prompt (Python, TypeScript, Go, Java) so your model has the most up-to-date information on DBOS.

Setup

Install uv

Before using this MCP server, you must install uv. For installation instructions, see the uv installation docs.

Setup with Claude Code

To use this MCP server with Claude Code, first install it:

claude mcp add dbos-conductor -- uvx dbos-mcp

Then start Claude Code and ask it questions about your DBOS apps! Claude will prompt you to log in by clicking the URL it offers and authenticating in the browser.

Credentials are stored in ~/.dbos-mcp/credentials.

Tools

Application Introspection

• list_applications - List all applications
• list_executors - List connected executors for an application

Workflow Introspection

• list_workflows - List/filter workflows
• get_workflow - Get workflow details
• list_steps - Get execution steps for a workflow

Workflow Management

• cancel_workflow - Cancel a running workflow
• resume_workflow - Resume a pending or failed workflow
• fork_workflow - Fork a workflow from a specific step

Authentication

• login - Start login flow (returns URL to login page)
• login_complete - Complete login after authenticating