Moon Banking MCP Server

Moon Banking — это глобальный каталог розничных и бизнес-банков со структурированными оценками сообщества по 14 категориям: обслуживание клиентов, комиссии и тарифы, цифровой опыт, дружелюбность к криптовалютам, безопасность и доверие, кредитование, бизнес-банкинг, международный банкинг, прозрачность и другие. MCP-сервер Moon Banking предоставляет весь этот набор данных — каждый банк, страну, оценку, голос и пользовательскую историю — в виде живых инструментов, которые может вызывать ваш ИИ-агент, чтобы ответы о реальном банковском деле опирались на свежие данные Moon Banking, а не на устаревшие предположения из обучающего набора.

После подключения вы можете задавать вопросы вроде «какие крипто-дружественные банки работают в Бразилии?», «сравните оценки цифрового опыта ведущих американских необанков» или «обобщите недавние пользовательские истории о комиссиях в HSBC UK» и получать ответы, основанные на инструментах и подкреплённые цитатами, опирающиеся на те же данные, что питают moonbanking.com.

Сервер генерируется из публичной спецификации OpenAPI и поставляется как в виде размещённой OAuth-конечной точки по адресу https://mcp.moonbanking.com/mcp, так и в виде npm-пакета stdio (@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

Аутентификация

Вы можете подключиться к Moon Banking через MCP, используя любой из двух методов аутентификации:

Оба метода предоставляют одинаковый набор инструментов; выбирайте тот, который подходит вашему клиенту.

Размещённый MCP-сервер (OAuth)

URL: https://mcp.moonbanking.com/mcp (Streamable HTTP, OAuth 2.0 с динамической регистрацией клиентов).

Большинство современных 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-пакет и аутентифицируйтесь с помощью API-ключа Moon Banking.

Прямой вызов

Вы можете запустить MCP-сервер напрямую через npx:

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: Эта конечная точка позволяет получать постраничный список всех банков. По умолчанию на странице отображается максимум десять банков. Вы можете искать банки по названию, фильтровать по стране, сортировать по различным полям и включать связанные данные, такие как оценки и информацию о стране.

• bank_getById: Эта конечная точка позволяет получать конкретный банк по идентификатору банка. Вы можете включить в ответ связанные данные, такие как оценки и информацию о стране.

• bank_semanticSearch: Поиск банков по описанию того, что вы ищете, на естественном языке. Поиск выполняется по описаниям банков, включая предлагаемые услуги, историю, местоположение, уникальные особенности и тип учреждения. Используйте это, когда пользователь спрашивает о банках с определёнными характеристиками, услугами или качествами.

• bankVote_get: Эта конечная точка позволяет получать постраничный список голосов за банки. Вы можете фильтровать по идентификатору банка, категории, стране, типу голоса (за или против) и другим параметрам.

• country_get: Эта конечная точка позволяет получать постраничный список всех стран. По умолчанию на странице отображается максимум десять стран. Вы можете искать страны по названию или двухбуквенному коду, сортировать по различным полям и включать связанные данные, такие как оценки.

• country_getByCountryCode: Эта конечная точка позволяет получать конкретную страну по двухбуквенному коду ISO страны. Вы можете включить в ответ связанные данные, такие как оценки.

• story_get: Эта конечная точка позволяет получать постраничный список всех историй. По умолчанию на странице отображается максимум десять историй. Вы можете искать истории по текстовому содержимому, фильтровать по идентификатору банка, сортировать по различным полям и включать связанные данные, такие как информация о банке и стране.

• story_getById: Эта конечная точка позволяет получать конкретную историю по идентификатору истории. Вы можете включить в ответ связанные данные, такие как информация о банке и стране.

• world_getOverview: Эта конечная точка позволяет получать глобальные обзорные данные, которые агрегируют голоса за банки, истории и другие данные по всем банкам во всех странах. Вы можете включить в ответ связанные данные, такие как оценки.

• market_get: Эта конечная точка позволяет получать постраничный список рынков (например, фондовых бирж). Вы можете искать по названию или коду, фильтровать по точному коду, стране или типу рынка и сортировать результаты.

• market_getById: Эта конечная точка позволяет получать конкретный рынок (например, фондовую биржу) по идентификатору рынка.

• stock_get: Эта конечная точка позволяет получать постраничный список биржевых листингов. Вы можете искать по тикеру, фильтровать по точному символу, рынку, банку или статусу первичного листинга и сортировать результаты.

• stock_getById: Эта конечная точка позволяет получать конкретный биржевой листинг по идентификатору акции. Вы можете дополнительно включить связанные market и/или bank как вложенные объекты.

• search_get: Поиск по банкам, странам, историям и акциям. Вы можете указать, какие сущности искать, с помощью параметра include. Если значение include не указано, будут искаться все сущности. Банки также сопоставляются по тикеру их биржевых листингов, поэтому поиск BAC возвращает Bank of America.

Лицензия

MIT