OpsNow FinOps MCP Server

Installation

Install the globally-available CLI from npm (선택사항):

npm install -g @opsnow-mcp/opsnow-mcp-finops-server

Usage

Claude Desktop Configuration

To integrate with Claude Desktop, add the following snippet to your claude_desktop_config.json:

{
  "mcpServers": {
    "opsnow-mcp-finops-server": {
      "command": "npx",
      "args": [
        "-y",
        "@opsnow-mcp/opsnow-mcp-finops-server",
        "--license-key",
        "YOUR_LICENSE_KEY"
      ]
    }
  }
}

Claude Desktop Configuration (Zscaler 환경)

Zscaler 프록시 환경에서는 TLS 인증서 오류를 방지하기 위해 NODE_EXTRA_CA_CERTS 환경 변수를 설정해야 합니다.

{
  "mcpServers": {
    "opsnow-mcp-finops-server": {
      "command": "npx",
      "args": [
        "@opsnow-mcp/opsnow-mcp-finops-server",
        "--license-key",
        "YOUR_LICENSE_KEY"
      ],
      "env": {
        "NODE_EXTRA_CA_CERTS": "C:\\ZscalerRootCA.pem"
      }
    }
  }
}

nvm(Node Version Manager) 사용 시 설정 예시

nvm을 사용하여 Node.js 22.x를 설치한 경우, 다음과 같이 설정할 수 있습니다. {사용자명} 부분은 본인의 사용자명으로 변경해주세요.

{
  "mcpServers": {
    "opsnow-mcp-finops-server": {
      "command": "npx",
      "args": [
        "@opsnow-mcp/opsnow-mcp-finops-server",
        "--license-key",
        "YOUR_LICENSE_KEY"
      ],
      "env": {
        "NODE_EXTRA_CA_CERTS": "/Users/{사용자명}/ZscalerRootCA.pem",
        "PATH": "/Users/{사용자명}/.nvm/versions/node/v22.14.0/bin:/usr/local/bin:/usr/bin:/bin",
        "NODE_PATH": "/Users/{사용자명}/.nvm/versions/node/v22.14.0/lib/node_modules"
      }
    }
  }
}

참고:

1. {사용자명}을 본인의 사용자명으로 변경하세요.
2. Node.js 22.x가 설치되어 있는지 확인하세요. 설치가 필요하다면 nvm install 22 명령어로 설치할 수 있습니다.
3. 사용 중인 Node.js 버전이 22.x가 아니라면, 위 설정에서 v22.14.0을 실제 사용 중인 22.x 버전으로 변경하세요.

로컬 개발 환경에서 실행

로컬에서 소스 코드를 직접 빌드하여 실행할 때는 --region local 옵션을 사용하여 로컬 API 서버(http://127.0.0.1:8080)에 연결할 수 있습니다.

1. 프로젝트를 빌드합니다:

npm run build

2. claude_desktop_config.json에 다음과 같이 설정합니다. {프로젝트경로}와 {사용자명} 부분은 본인의 환경에 맞게 변경해주세요.

{
  "mcpServers": {
    "opsnow-mcp-finops-server": {
      "command": "node",
      "args": [
        "{프로젝트경로}/build/index.js",
        "--license-key",
        "YOUR_LICENSE_KEY",
        "--region",
        "local"
      ],
      "env": {
        "NODE_EXTRA_CA_CERTS": "/Users/{사용자명}/Downloads/ZscalerRootCA.pem",
        "PATH": "/Users/{사용자명}/.nvm/versions/node/v24.12.0/bin:/usr/local/bin:/usr/bin:/bin",
        "NODE_PATH": "/Users/{사용자명}/.nvm/versions/node/v24.12.0/lib/node_modules"
      }
    }
  }
}

참고:

1. {프로젝트경로}를 실제 프로젝트 디렉토리의 절대 경로로 변경하세요 (예: /Users/{사용자명}/dev/opsnow-mcp-finops-server).
2. --region 옵션에 사용 가능한 값: default, dev-us2, uae, local
3. local 리전은 http://127.0.0.1:8080에 연결되므로, 로컬에서 API 서버가 실행 중이어야 합니다.
4. npx 대신 node 명령어로 빌드된 build/index.js를 직접 실행합니다.

소개

OpsNow FinOps MCP(Module Context Protocol) Server는 Claude Desktop App과 같은 MCP Client에 OpsNow에서 제공하는 클라우드 비용과 클라우드 제품 사용량 데이터를 제공하는 서버입니다.

시스템 구조

graph LR
    A[LLM Vendor Desktop App] --> |MCP Protocol| B[OpsNow FinOps MCP Server]:::highlight
    B --> C[OpsNow MCP Provider]
    C --> D[OpsNow Resources]
    
    classDef highlight fill:#2e8b57,stroke:#333,stroke-width:2px;

• LLM Vendor Desktop App: Claude와 같은 LLM 기반 데스크톱 애플리케이션
• OpsNow FinOps MCP Server: Asset 및 Cost 데이터를 MCP 형식으로 제공하는 서버
• OpsNow MCP Provider: OpsNow API Bridge를 통해 자원 데이터를 처리
• OpsNow Resources: 실제 OpsNow 리소스 데이터를 가정한 목데이터로 구현 (개발 및 테스트 목적)

주요 기능

• MCP 프로토콜을 통한 데이터 제공
• OpsNow에서 제공하는 클라우드 비용과 클라우드 제품 사용량 데이터 제공
• MCP Client와의 효율적인 통신

기술 스택

• Node.js
• TypeScript
• MCP SDK (@modelcontextprotocol/sdk)
• dotenv
• zod
• axios

개발 환경 설정

필수 요구사항

• Node.js 18.x 이상
• npm 9.x 이상

사용 방법

비용 데이터 조회 예시

• "AWS 비용을 알려줘 (2025년 6월)"
• "Azure 비용을 알려줘 (2025년 6월)"
• "GCP 비용을 알려줘 (2025년 6월)"

사용량 데이터 조회 예시

• "AWS EC2 사용량을 알려줘"
• "Azure VM 사용량을 알려줘"
• "GCP VM 인스턴스 사용량을 알려줘"