apogeoapi-mcp — MCP-сервер для Claude Code: функции и установка
Сервер даёт ИИ-агенту инструменты для поиска географических данных, проверки валютных курсов и определения местоположения IP. Для работы нужен ключ ApogeoAPI.
claude mcp add --env APOGEOAPI_KEY=<APOGEOAPI_KEY> --transport stdio apogeoapi-mcp -- npx -y @apogeoapi/mcpЧто делает apogeoapi-mcp
apogeoapi-mcp подключает к агенту инструменты ApogeoAPI. С их помощью можно получать сведения о странах, штатах и городах, искать места, узнавать курс валют и определять геолокацию IPv4- или IPv6-адреса. Например, агент может найти страну по коду или определить регион по IP.
Все инструменты доступны только для чтения. Для установки через Claude Code используется npx; ключ API передаётся через переменную APOGEOAPI_KEY. Без ключа сервер не получит доступ к API. Сведения о странах и штатах доступны на Free-плане, а для городов, глобального поиска, курсов и геолокации IP нужен Basic+ или пробный период.
Какие задачи решает
- найти страну по коду ISO2 или ISO3
- получить список штатов или провинций страны
- узнать актуальный курс USD для валюты страны
- определить страну и регион по IP-адресу
Примеры запросов агенту
- Найди страну по коду ISO2 и покажи её столицу и валюту.
- Определи страну, регион и часовой пояс для IP-адреса 8.8.8.8.
- Покажи текущий курс USD для валюты Аргентины.
Как установить apogeoapi-mcp
Командой платформы
claude mcp add --env APOGEOAPI_KEY=<APOGEOAPI_KEY> --transport stdio apogeoapi-mcp -- npx -y @apogeoapi/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add apogeoapi-mcp --env APOGEOAPI_KEY=<APOGEOAPI_KEY> -- npx -y @apogeoapi/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"apogeoapi-mcp": {
"command": "npx",
"args": [
"-y",
"@apogeoapi/mcp"
],
"env": {
"APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"apogeoapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@apogeoapi/mcp"
],
"env": {
"APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APOGEOAPI_KEY=<APOGEOAPI_KEY> apogeoapi-mcp npx -y @apogeoapi/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о apogeoapi-mcp
Как установить apogeoapi-mcp в Claude Code?
Добавьте сервер командой claude mcp add --env APOGEOAPI_KEY=<APOGEOAPI_KEY> --transport stdio apogeoapi-mcp -- npx -y @apogeoapi/mcp, подставив API-ключ вместо <APOGEOAPI_KEY>. Этот ключ передаётся серверу через переменную окружения.
Что делает apogeoapi-mcp?
Он подключает инструменты ApogeoAPI к ИИ-агенту: для работы с данными о странах, штатах и городах, валютными курсами и геолокацией IP. Инструменты не изменяют данные.
Нужен ли платный план для геолокации IP?
Для инструмента геолокации IP требуется Basic+ или доступ в течение пробного периода. Ключ API нужен в любом случае.
