ynab-mcp

YNAB MCP 서버

YNAB(You Need A Budget)와 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude Desktop과 같은 MCP 지원 클라이언트를 통해 예산 데이터에 접근할 수 있는 도구를 제공합니다.

MCP 클라이언트 구성

기본 구성

MCP 클라이언트 구성에 다음을 추가합니다(예: Claude Desktop의 경우 cline_mcp_settings.json ):

지엑스피1

고급 구성

특정 디렉토리에서 실행하는 경우:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

디버깅

MCP 검사기로 디버깅하려면:

검사기를 설치하세요:

npm install -g @modelcontextprotocol/inspector

uv와 함께 검사기를 사용하도록 구성을 업데이트하세요.

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "@modelcontextprotocol/inspector", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

검사관은 다음을 제공합니다.

도구 호출 및 응답의 실시간 로그
요청/응답 검사
도구 스키마 검증
대화형 테스트 인터페이스

사용 가능한 도구

사용자 가져오기

사용자 ID와 이메일을 포함하여 인증된 YNAB 사용자에 대한 정보를 검색합니다.

리스트버짓

예산 ID와 이름을 포함하여 인증된 사용자가 액세스할 수 있는 모든 예산을 나열합니다.

겟버짓

거래 내역, 범주, 잔액을 포함하여 특정 예산에 대한 자세한 정보를 검색합니다. 날짜 필터링 및 거래 제한 기능을 선택적으로 지원합니다.

참고: 금액은 밀리단위로 반환됩니다(예: 1000 = $1.00).

GetBudget 카테고리

지정된 예산에 정의된 모든 카테고리(카테고리 그룹, 이름, ID 포함)를 검색합니다.

예산 설정 가져오기

통화 형식, 날짜 형식 및 기타 기본 설정을 포함하여 지정된 예산에 대한 설정을 검색합니다.