# apogeoapi-mcp

Сервер даёт ИИ-агенту инструменты для поиска географических данных, проверки валютных курсов и определения местоположения IP. Для работы нужен ключ ApogeoAPI.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Автор: APOGEOAPI
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/APOGEOAPI/apogeoapi-mcp
- Обновлён: 2026-10-01
- HTML: https://affpapa.org/nevibecode/mcp/apogeoapi-mcp

## Что делает

apogeoapi-mcp подключает к агенту инструменты ApogeoAPI. С их помощью можно получать сведения о странах, штатах и городах, искать места, узнавать курс валют и определять геолокацию IPv4- или IPv6-адреса. Например, агент может найти страну по коду или определить регион по IP.

Все инструменты доступны только для чтения. Для установки через Claude Code используется `npx`; ключ API передаётся через переменную `APOGEOAPI_KEY`. Без ключа сервер не получит доступ к API. Сведения о странах и штатах доступны на Free-плане, а для городов, глобального поиска, курсов и геолокации IP нужен Basic+ или пробный период.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `APOGEOAPI_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env APOGEOAPI_KEY=<APOGEOAPI_KEY> --transport stdio apogeoapi-mcp -- npx -y @apogeoapi/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add apogeoapi-mcp --env APOGEOAPI_KEY=<APOGEOAPI_KEY> -- npx -y @apogeoapi/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "apogeoapi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@apogeoapi/mcp"
            ],
            "env": {
                "APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "apogeoapi-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@apogeoapi/mcp"
            ],
            "env": {
                "APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e APOGEOAPI_KEY=<APOGEOAPI_KEY> apogeoapi-mcp npx -y @apogeoapi/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти страну по коду ISO2 или ISO3
- получить список штатов или провинций страны
- узнать актуальный курс USD для валюты страны
- определить страну и регион по IP-адресу

## Примеры запросов агенту
- Найди страну по коду ISO2 и покажи её столицу и валюту.
- Определи страну, регион и часовой пояс для IP-адреса 8.8.8.8.
- Покажи текущий курс USD для валюты Аргентины.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16730
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24271
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7548

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md