Monobank MCP 서버 (Node.js/TypeScript)

파이썬으로 작성된 Monobank MCP Server의 Node.js/TypeScript 구현체입니다.

Monobank MCP 서버는 귀하의 Monobank 개인 계정(및 공개 환율)을 Model Context Protocol(MCP) 도구로 노출합니다.

이 버전에 대하여

이 버전은 @nklymok의 원본 파이썬 구현을 Node.js/TypeScript로 포팅한 것입니다.

• 원본 파이썬 버전: https://github.com/nklymok/Monobank-MCP

• 본 TypeScript 버전: Node.js/TypeScript 생태계의 이점을 활용하여 동일한 핵심 개인 계정 도구를 유지하며, 토큰이 필요 없는 공개 환율 도구를 추가했습니다.

Related MCP server: Monobank MCP Server

기능

• 공식 @modelcontextprotocol/sdk를 사용하는 TypeScript/Node.js MCP 서버

• MCP 도구:

  • get_client_info – 고객 식별 정보, 계좌 및 저금통(jars) 정보 ( MONOBANK_API_TOKEN 필요).

  • get_statement – 특정 기간의 계좌 거래 내역 (토큰 필요). API 호출 전 기간을 검증하며, 응답은 주요 단위의 금액과 ISO 8601 UTC 시간 형식의 거래 시간을 사용합니다.

  • get_currency_rates – Monobank에서 제공하는 공개 환율 (GET /bank/currency). API 토큰 불필요.

사용법 (배포된 패키지)

이 MCP 서버를 사용하는 가장 쉬운 방법은 배포된 npm 패키지를 이용하는 것입니다:

1. MCP 설정에 서버 등록

   {
     "mcpServers": {
       "monobank-mcp": {
         "command": "npx",
         "args": ["-y", "@alerix/monobank-mcp"],
         "env": {
           "MONOBANK_API_TOKEN": "your_token_here"
         }
       }
     }
   }

   get_client_info 또는 **get_statement**를 사용하는 경우에만 MONOBANK_API_TOKEN을 설정하세요. **get_currency_rates**는 토큰 없이 작동합니다.

2. MCP 클라이언트 실행 – 설정에 따라 도구를 사용할 수 있게 됩니다.

개발

서버에 기여하거나 수정하려면 다음 단계를 따르세요:

1. 복제 및 의존성 설치

   git clone https://github.com/aler1x/monobank-mcp.git
   cd monobank-mcp
   npm install

2. 서버 실행 (설치 후 prepare가 npm run build를 실행함). 개인 도구를 사용하려면 MONOBANK_API_TOKEN을 설정하세요.

   Windows (PowerShell):

   $env:MONOBANK_API_TOKEN="your_token_here"
   node dist/index.js

   Windows (명령 프롬프트):

   set MONOBANK_API_TOKEN=your_token_here
   node dist\index.js

   macOS/Linux:

   export MONOBANK_API_TOKEN=your_token_here
   node dist/index.js

   또는 한 줄로 실행:

   MONOBANK_API_TOKEN=your_token_here node dist/index.js

3. 핫 리로드를 사용한 개발 (tsx --watch 사용):

   MONOBANK_API_TOKEN=your_token_here npm run dev

4. 빌드 (TypeScript → dist/):

   npm run build

도구 참조

API 토큰

개인 도구를 사용하려면 Monobank 개인 API 토큰이 필요합니다. 공식 문서를 참조하세요: https://api.monobank.ua/index.html

환경 변수

라이선스

MIT