Moon Banking MCP 서버

Moon Banking은 14개 카테고리(고객 서비스, 수수료 및 가격, 디지털 경험, 암호화폐 친화성, 보안 및 신뢰, 대출, 기업 뱅킹, 국제 뱅킹, 투명성 등)에 걸쳐 구조화된 커뮤니티 평가 점수를 갖춘 전 세계 소비자 및 기업 은행 디렉토리입니다. Moon Banking MCP 서버는 모든 은행, 국가, 점수, 투표 및 사용자 스토리가 포함된 전체 데이터셋을 AI 에이전트가 호출할 수 있는 라이브 도구로 노출하므로, 실제 은행 관련 질문에 대한 답변은 낡은 훈련 데이터셋의 추측 대신 최신 Moon Banking 데이터에 기반합니다.

연결 후에는 "브라질에서 운영되는 암호화폐 친화적 은행은 어디인가요?", "미국 주요 챌린저 은행들의 디지털 경험 점수를 비교해 주세요", "HSBC UK의 수수료에 관한 최근 사용자 스토리를 요약해 주세요" 같은 질문을 할 수 있으며, moonbanking.com을 구동하는 동일한 데이터에 기반한 도구 기반의 인용 가능한 답변을 얻을 수 있습니다.

이 서버는 공개 OpenAPI 사양에서 생성되었으며, https://mcp.moonbanking.com/mcp의 호스팅된 OAuth 엔드포인트와 stdio npm 패키지(@moonbanking/mcp-server) 형태로 제공됩니다. 따라서 Claude, Cursor, Grok, ChatGPT, VS Code, Devin Desktop (구 Windsurf), Zed 및 기타 모든 Model Context Protocol 클라이언트에 연결할 수 있습니다.

클라이언트별 설정 가이드

Moon Banking을 특정 클라이언트에 연결하려면 해당 가이드로 바로 이동하세요. 각 가이드는 호스팅된 OAuth 설정과 자체 호스팅 stdio 대체 방법을 모두 다룹니다.

이 README의 나머지 부분에서는 기본 인증 옵션과 구성 형식을 다룹니다.

Related MCP server: WalletGrower MCP Server

인증

MCP를 통해 Moon Banking에 연결할 때 두 가지 인증 방법 중 하나를 사용할 수 있습니다:

두 방법 모두 동일한 도구 세트를 노출합니다. 클라이언트에 맞는 방법을 선택하세요.

호스팅된 MCP 서버 (OAuth)

URL: https://mcp.moonbanking.com/mcp (Streamable HTTP, OAuth 2.0 with Dynamic Client Registration).

대부분의 최신 MCP 클라이언트는 URL을 가리키기만 하면 연결할 수 있습니다. 클라이언트가 브라우저 창을 띄워 사용자가 Moon Banking에 로그인하고 액세스 토큰을 자동으로 얻도록 합니다. API 키는 클라이언트 측에서 교환되거나 저장되지 않습니다.

{
  "mcpServers": {
    "moonbanking": {
      "url": "https://mcp.moonbanking.com/mcp"
    }
  }
}

원격 MCP를 기본적으로 지원하지 않는 클라이언트(예: 구형 ChatGPT 구성)의 경우 mcp-remote 브리지가 호스팅된 엔드포인트를 stdio 명령으로 래핑할 수 있습니다:

{
  "mcpServers": {
    "moonbanking": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.moonbanking.com/mcp"]
    }
  }
}

자체 호스팅 (API 키)

MCP 서버를 로컬에서 stdio 프로세스로 실행하려는 경우 — 예를 들어 OAuth용 브라우저를 사용할 수 없는 자동화에 포함하려는 경우 — 이 npm 패키지를 설치하고 Moon Banking API 키로 인증하세요.

직접 호출

npx를 통해 MCP 서버를 직접 실행할 수 있습니다:

export MOON_BANKING_API_KEY="Bearer mb_sk_..."
npx -y @moonbanking/mcp-server

MCP 클라이언트를 통한 방법

기존 클라이언트의 일부 목록은 modelcontextprotocol.io에서 확인할 수 있습니다. 이미 클라이언트가 있다면 해당 문서를 참조하여 MCP 서버를 설치하세요.

구성 JSON이 있는 클라이언트의 경우 다음과 비슷할 수 있습니다:

{
  "mcpServers": {
    "moonbanking-mcp": {
      "command": "npx",
      "args": ["-y", "@moonbanking/mcp-server"],
      "env": {
        "MOON_BANKING_API_KEY": "Bearer mb_sk_..."
      }
    }
  }
}

특정 도구 필터링

--tool 플래그를 사용하여 노출되는 도구를 제한할 수 있습니다:

npx @moonbanking/mcp-server --tool=tool1 --tool=tool2

사용 가능한 도구

• bank_getByHostname: 이 엔드포인트를 사용하면 호스트 이름으로 은행을 검색할 수 있습니다. 제공된 호스트 이름과 일치하는 국가별 은행을 최대 하나까지 반환합니다. 호스트 이름은 정규화되고(www. 접두사가 있으면 제거) 기본 호스트 이름 및 대체 호스트 이름과 모두 대조됩니다.

• bank_get: 이 엔드포인트를 사용하면 모든 은행의 페이징된 목록을 검색할 수 있습니다. 기본적으로 페이지당 최대 10개의 은행이 표시됩니다. 이름으로 은행을 검색하고, 국가별로 필터링하고, 다양한 필드로 정렬하고, 점수 및 국가 정보와 같은 관련 데이터를 포함할 수 있습니다.

• bank_getById: 이 엔드포인트를 사용하면 은행 ID를 제공하여 특정 은행을 검색할 수 있습니다. 응답에 점수 및 국가 정보와 같은 관련 데이터를 포함할 수 있습니다.

• bank_semanticSearch: 찾고 있는 것을 자연어로 설명하여 은행을 검색합니다. 제공되는 서비스, 역사, 위치, 고유 기능, 기관 유형을 포함한 은행 설명 전반을 검색합니다. 사용자가 특정 특성, 서비스 또는 품질을 가진 은행에 대해 물을 때 사용하세요.

• bankVote_get: 이 엔드포인트를 사용하면 은행 투표의 페이징된 목록을 검색할 수 있습니다. 은행 ID, 카테고리, 국가, 투표 유형(찬성 또는 반대) 및 기타 매개변수로 필터링할 수 있습니다.

• country_get: 이 엔드포인트를 사용하면 모든 국가의 페이징된 목록을 검색할 수 있습니다. 기본적으로 페이지당 최대 10개의 국가가 표시됩니다. 이름 또는 2자리 코드로 국가를 검색하고, 다양한 필드로 정렬하고, 점수와 같은 관련 데이터를 포함할 수 있습니다.

• country_getByCountryCode: 이 엔드포인트를 사용하면 2자리 ISO 국가 코드를 제공하여 특정 국가를 검색할 수 있습니다. 응답에 점수와 같은 관련 데이터를 포함할 수 있습니다.

• story_get: 이 엔드포인트를 사용하면 모든 스토리의 페이징된 목록을 검색할 수 있습니다. 기본적으로 페이지당 최대 10개의 스토리가 표시됩니다. 텍스트 내용으로 스토리를 검색하고, 은행 ID로 필터링하고, 다양한 필드로 정렬하고, 은행 및 국가 정보와 같은 관련 데이터를 포함할 수 있습니다.

• story_getById: 이 엔드포인트를 사용하면 스토리 ID를 제공하여 특정 스토리를 검색할 수 있습니다. 응답에 은행 및 국가 정보와 같은 관련 데이터를 포함할 수 있습니다.

• world_getOverview: 이 엔드포인트를 사용하면 모든 국가의 모든 은행에 걸친 은행 투표, 스토리 및 기타 데이터를 집계하는 글로벌 개요 데이터를 검색할 수 있습니다. 응답에 점수와 같은 관련 데이터를 포함할 수 있습니다.

• market_get: 이 엔드포인트를 사용하면 시장(예: 증권 거래소)의 페이징된 목록을 검색할 수 있습니다. 이름 또는 코드로 검색하고, 정확한 코드, 국가 또는 시장 유형으로 필터링하고, 결과를 정렬할 수 있습니다.

• market_getById: 이 엔드포인트를 사용하면 시장 ID를 제공하여 특정 시장(예: 증권 거래소)을 검색할 수 있습니다.

• stock_get: 이 엔드포인트를 사용하면 주식 상장 종목의 페이징된 목록을 검색할 수 있습니다. 티커 심볼로 검색하고, 정확한 심볼, 시장, 은행 또는 주요 상장 상태로 필터링하고, 결과를 정렬할 수 있습니다.

• stock_getById: 이 엔드포인트를 사용하면 주식 ID를 제공하여 특정 주식 상장 종목을 검색할 수 있습니다. 선택적으로 관련 market 및/또는 bank를 중첩 객체로 포함할 수 있습니다.

• search_get: 은행, 국가, 스토리 및 주식을 검색합니다. include 매개변수를 사용하여 검색할 엔터티를 지정할 수 있습니다. include 값이 제공되지 않으면 모든 엔터티가 검색됩니다. 은행은 주식 상장의 티커 심볼과도 일치하므로 BAC를 검색하면 Bank of America가 반환됩니다.

라이선스

MIT