tkawen

MCP-сервер для Алжира. Реальные алжирские данные для любого ИИ-ассистента — все 69 вилай, 1 581 коммуна, проверка телефонных номеров, а также электронная коммерция, экономика наложенного платежа, проверка сертификатов, сертифицированные специалисты и профессиональное обучение. 35 инструментов. Ноль зависимостей. Без API-ключа.

npx -y tkawen

Зачем это существует

Спросите любую модель, сколько провинций в Алжире, и она ответит 58.

В Алжире 69 вилай с 16 ноября 2025 года, когда одиннадцать делегированных провинций были повышены в статусе. Спросите о коммунах Тимимуна — и модель выдумает правдоподобные арабские топонимы. Спросите, является ли 0770112233 действительным алжирским номером — и она будет гадать.

Это не пробел, который закрывает более крупная модель. Это проблема данных, и вот эти данные.

> How many wilayas does Algeria have, and list them?

Algeria — 69 wilayas, 1,581 communes.
The 2025 reform promoted 11 delegated provinces to full wilayas on 16 Nov 2025.
Any list of 58 is stale.

01  Adrar                  أدرار                   16 communes
02  Chlef                  الشلف                   35 communes
...
69  El Abiodh Sidi Cheikh  الأبيض سيدي الشيخ        9 communes

Related MCP server: Australian Postcodes MCP Server

Установка

Добавьте его в конфиг вашего MCP-клиента:

{
  "mcpServers": {
    "tkawen": {
      "command": "npx",
      "args": ["-y", "tkawen"]
    }
  }
}

Работает с Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Zed и всем остальным, что говорит на MCP через stdio. Это вся установка — без аккаунта, без ключа, без регистрации.

🇩🇿 API данных об Алжире

Флагманский продукт. Два инструмента, отвечающие из локального набора данных, поэтому они отвечают за миллисекунды и продолжают работать, даже когда все остальные сервисы недоступны.

algeria_geospatial

Латиница и арабский равноправны: Alger, الجزائر, الجزاير и alger все разрешаются в вилайю 16.

algeria_telecom_validator

Принимает любой формат, который реально пишет алжирец — +213…, 00213…, 213…, голый 9-значный номер, пробелы, дефисы и арабо-индийские цифры (٠٥٥٥١٢٣٤٥٦):

input:    ٠٥٥٥١٢٣٤٥٦
local:    0555123456
E.164:    +213555123456
whatsapp: 213555123456
type:     mobile
issuer:   Ooredoo (originally allocated)

Мобильные (05 / 06 / 07) и стационарные номера Algérie Télécom (02 / 03) — оба типа проверяются.

Две вещи, которые он не будет делать, потому что быть полезным важнее, чем выглядеть полным:

• Оператор — это первоначальное распределение. Переносимость номеров действует в Алжире с 2017 года, поэтому 07 больше не означает Djezzy. Указывается как «первоначально выделен», никогда — как факт.

• Стационарные номера не привязаны к вилайе. Алжирские коды городов не следуют нумерации вилай — Алжир — это 021 в вилайе 16, Оран — 041 в вилайе 31. Авторитетной таблицы кодов здесь нет, а выдумывать её — значит помещать вымышленную географию внутрь инструмента, созданного, чтобы остановить модели, выдумывающие алжирскую географию.

Остальные 33 инструмента

Начните с tkawen_search_tools — опишите, что вам нужно, простыми словами, и он вернёт только подходящие инструменты, вместо загрузки 35 схем в ваш контекст. Он понимает арабский, французский и английский.

Электронная коммерция (MyStoq) — cod_profit (реальная чистая прибыль с учётом доли отказов) · order_risk (оценка мошенничества при наложенном платеже) · yalidine_delivery (доли возвратов и сроки доставки по вилайям) · search_stores · get_store · list_plans · platform_stats · create_store · create_product · set_price · publish · delete_product

Сертификаты (AlgeriaCertify) — verify_certificate · search_certified_talent · match_talent_to_job · get_talent_profile · list_specialties · list_institutions · platform_stats

Обучение — search_trainings · get_training · list_categories · request_quote · list_individual_trainings · catalogue_stats

Встречи (LIQAA) — create_instant_room · list_plans · platform_capacity · platform_stats

Мета — tkawen_search_tools · tkawen_overview · tkawen_recommend · tkawen_verify

Реальные вопросы, на которые они отвечают:

Запись, а не только чтение

Большинство инструментов доступны только для чтения и ничего не требуют. Те, что создают что-то, действуют от имени реального аккаунта и требуют токен:

{
  "mcpServers": {
    "tkawen": {
      "command": "npx",
      "args": ["-y", "tkawen"],
      "env": { "TKAWEN_TOKEN": "your-token" }
    }
  }
}

Без него они отказываются. Ничто не создаётся случайно.

Архитектура

stdio-мост, ~190 строк, к TKAWEN Intelligence Gateway по адресу https://mcp.tkawen.com. Важно точно понимать, что это значит:

• Ваши запросы покидают вашу машину. Вызовы инструментов идут на mcp.tkawen.com через HTTPS. Если это неприемлемо для ваших данных — не устанавливайте. Сказано здесь, а не спрятано на странице конфиденциальности.

• Инструментов нет в этом пакете. Они живут на шлюзе, поэтому инструмент, добавленный во вторник, работает у вас без обновления и без рассинхронизации версий.

• Ноль зависимостей. Встроенный fetch из Node и ничего больше — npx остаётся быстрым, и нет дерева зависимостей, которое можно скомпрометировать на пути, ведущем к живому API.

• stdout несёт только протокол и ничего больше. Один случайный console.log портит поток JSON-RPC, и клиент сообщает «сервер отключился» без объяснения причин. Каждая диагностика идёт в stderr.

• Он корректно завершается с ошибкой. Шлюз недоступен, таймаут, повреждённая строка, ответ не в JSON: вы получаете корректную ошибку JSON-RPC и чистый выход, никогда — краш или повреждённый поток. Каждый из этих случаев покрыт тестом.

Зарегистрирован в официальном реестре MCP как com.tkawen/intelligence-gateway.

Конфигурация

Node 18+. В более старых версиях нет глобального fetch; мост сообщает об этом и завершает работу, а не падает так, что вам пришлось бы отлаживать.

Тесты

npm test     # 10 tests, no network — framing, errors, stdout purity
npm run smoke # hits the live gateway, asserts 69 wilayas

Модульные тесты намеренно запускаются против mock-шлюза: красный test означает, что сломался этот пакет, а красный smoke — что шлюз недоступен. Объединение этих двух вещей превратило бы любой сетевой сбой в видимость регрессии кода.

Лицензия

MIT — создано в Аннабе компанией TKAWEN.