mcp-brasil-api — MCP-сервер для Claude Code: данные Бразилии
Даёт агенту доступ к открытым данным Бразилии: адреса по CEP, компании по CNPJ, банки, праздники, погода и таблица FIPE.
claude mcp add mcp-brasil-api -- npx -y @codespar/mcp-brasil-apiЧто делает mcp-brasil-api
MCP-сервер оборачивает BrasilAPI — бесплатный публичный набор бразильских данных. Внутри 24 инструмента: get_cep и get_cep_v1 ищут адрес по почтовому индексу, get_cnpj тянет сведения о компании, get_banks и get_corretoras перечисляют банки и брокеров, get_fipe_price и get_fipe_vehicles работают с ценами на автомобили. Отдельно идут погода CPTEC/INPE, включая METAR по коду ICAO, праздники по году, коды DDD, ISBN, NCM и курсы Selic, CDI, IPCA.
Запускается через npx, ставить глобально ничего не нужно. Ключ API не требуется, переменные окружения тоже: BrasilAPI открыт для всех запросов. Для Claude хватит одной команды claude mcp add brasil-api -- npx -y @codespar/mcp-brasil-api; в Cursor и VS Code тот же сервер прописывается в .cursor/mcp.json или .vscode/mcp.json.
Данные приходят из внешнего публичного API, поэтому при его недоступности инструменты молча вернут ошибку. Если проект не связан с Бразилией, пользы от сервера не будет — все инструменты заточены под её реестры и справочники. Лицензия MIT, код лежит в репозитории codespar/mcp-dev-latam.
Какие задачи решает
- найти адрес и район по бразильскому почтовому индексу CEP
- подтянуть реквизиты компании по CNPJ
- сравнить цены на автомобиль по таблице FIPE
- узнать национальные праздники на нужный год
- посмотреть прогноз погоды или METAR по коду аэропорта
Примеры запросов агенту
- Найди адрес по CEP 01310-100
- Покажи данные компании по CNPJ 00.000.000/0001-00
- Какая сейчас погода в аэропорту с кодом SBGR?
Как установить mcp-brasil-api
Командой платформы
claude mcp add mcp-brasil-api -- npx -y @codespar/mcp-brasil-apiКомандой платформы
codex mcp add brasil-api -- npx -y @codespar/mcp-brasil-apiФайл настроек
{
"mcpServers": {
"brasil-api": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-brasil-api"
]
}
}
}Файл настроек
{
"servers": {
"brasil-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-brasil-api"
]
}
}
}Командой платформы
gemini mcp add brasil-api npx -y @codespar/mcp-brasil-apiПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-brasil-api
Как установить mcp-brasil-api в Claude Code?
Выполните claude mcp add brasil-api -- npx -y @codespar/mcp-brasil-api. Сервер запустится через npx, отдельная установка пакета не нужна.
Что делает mcp-brasil-api?
Открывает агенту 24 инструмента к BrasilAPI: поиск по CEP и CNPJ, списки банков и брокеров, праздники, погода CPTEC/INPE, таблица FIPE, коды DDD, ISBN и NCM, текущие ставки Selic, CDI и IPCA.
Нужен ли ключ API или переменные окружения?
Нет. BrasilAPI — бесплатный публичный API, авторизация не требуется, переменные окружения не задаются. Достаточно установить сервер и пользоваться.