Nigeria Postcode — MCP-сервер для Claude Code: функции и установка
Сервер помогает проверять и находить цифровые почтовые индексы Нигерии. Он пригодится, если агенту нужно связать адрес или координаты с индексом NIPOST.
claude mcp add --env NG_POSTCODE_API_KEY=<NG_POSTCODE_API_KEY> --env NG_POSTCODE_MAX_LEVEL=<NG_POSTCODE_MAX_LEVEL> --env NG_POSTCODE_MAX_PAID_CALLS=<NG_POSTCODE_MAX_PAID_CALLS> --env NG_POSTCODE_BASE_URL=<NG_POSTCODE_BASE_URL> --env NG_GEOCODER_URL=<NG_GEOCODER_URL> --transport stdio mcp -- npx -y ng-postcode-mcpЧто делает Nigeria Postcode
Nigeria Postcode даёт агенту инструменты для проверки структуры индекса, поиска назначенного зданию кода, автодополнения и поиска ближайшего здания по координатам. Инструмент подробного поиска возвращает сведения об адресе и назначении здания; такие вызовы расходуют кредиты. Остальные перечисленные инструменты доступны без оплаты или в бесплатном тарифе.
Для работы сервера нужны Node.js с npx и ключ NIPOST для запросов к API. Проверка структуры работает без ключа. Чтобы преобразовывать текстовое описание адреса в индекс, настройте геокодер; для точного кода здания текстового описания может не хватить, поэтому агенту пригодится метка на карте. Сервер также ограничивает уровень поиска и число платных запросов переменными окружения: повышение уровня может расходовать кредиты.
Какие задачи решает
- проверить структуру индекса Нигерии без обращения к API
- найти индекс здания по коду или координатам
- дополнить частично введённый индекс
- преобразовать описание адреса или метку на карте в индекс
Примеры запросов агенту
- Проверь структуру индекса
1234-5678и предложи исправление, если найдёшь похожие символы. - Найди почтовый индекс здания по этим координатам.
- Определи индекс по этому адресу; если точный адрес неясен, попроси метку на карте.
Как установить Nigeria Postcode
Командой платформы
claude mcp add --env NG_POSTCODE_API_KEY=<NG_POSTCODE_API_KEY> --env NG_POSTCODE_MAX_LEVEL=<NG_POSTCODE_MAX_LEVEL> --env NG_POSTCODE_MAX_PAID_CALLS=<NG_POSTCODE_MAX_PAID_CALLS> --env NG_POSTCODE_BASE_URL=<NG_POSTCODE_BASE_URL> --env NG_GEOCODER_URL=<NG_GEOCODER_URL> --transport stdio mcp -- npx -y ng-postcode-mcpВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add mcp --env NG_POSTCODE_API_KEY=<NG_POSTCODE_API_KEY> --env NG_POSTCODE_MAX_LEVEL=<NG_POSTCODE_MAX_LEVEL> --env NG_POSTCODE_MAX_PAID_CALLS=<NG_POSTCODE_MAX_PAID_CALLS> --env NG_POSTCODE_BASE_URL=<NG_POSTCODE_BASE_URL> --env NG_GEOCODER_URL=<NG_GEOCODER_URL> -- npx -y ng-postcode-mcpВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"ng-postcode-mcp"
],
"env": {
"NG_POSTCODE_API_KEY": "<NG_POSTCODE_API_KEY>",
"NG_POSTCODE_MAX_LEVEL": "<NG_POSTCODE_MAX_LEVEL>",
"NG_POSTCODE_MAX_PAID_CALLS": "<NG_POSTCODE_MAX_PAID_CALLS>",
"NG_POSTCODE_BASE_URL": "<NG_POSTCODE_BASE_URL>",
"NG_GEOCODER_URL": "<NG_GEOCODER_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ng-postcode-mcp"
],
"env": {
"NG_POSTCODE_API_KEY": "<NG_POSTCODE_API_KEY>",
"NG_POSTCODE_MAX_LEVEL": "<NG_POSTCODE_MAX_LEVEL>",
"NG_POSTCODE_MAX_PAID_CALLS": "<NG_POSTCODE_MAX_PAID_CALLS>",
"NG_POSTCODE_BASE_URL": "<NG_POSTCODE_BASE_URL>",
"NG_GEOCODER_URL": "<NG_GEOCODER_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e NG_POSTCODE_API_KEY=<NG_POSTCODE_API_KEY> -e NG_POSTCODE_MAX_LEVEL=<NG_POSTCODE_MAX_LEVEL> -e NG_POSTCODE_MAX_PAID_CALLS=<NG_POSTCODE_MAX_PAID_CALLS> -e NG_POSTCODE_BASE_URL=<NG_POSTCODE_BASE_URL> -e NG_GEOCODER_URL=<NG_GEOCODER_URL> mcp npx -y ng-postcode-mcpВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Nigeria Postcode
Как установить Nigeria Postcode в Claude Code?
Выполните claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=<NG_POSTCODE_API_KEY> -- npx -y ng-postcode-mcp. Укажите ключ NIPOST вместо плейсхолдера.
Что делает Nigeria Postcode?
MCP-сервер проверяет индексы Нигерии, ищет код здания по индексу или координатам и помогает разбирать адреса. Подробный поиск сведений о здании расходует кредиты.
Нужен ли ключ API для проверки индекса?
Для проверки структуры ключ не требуется. Поиск назначенного кода, автодополнение и поиск по координатам требуют ключ NIPOST; для разбора текстового адреса нужен ещё геокодер.
