tkawen

Der MCP-Server für Algerien. Echte algerische Daten für jeden KI-Assistenten — alle 69 Wilayas, 1.581 Gemeinden, Telefonvalidierung, plus E-Commerce, Nachnahme-Ökonomie, Anmeldeinformationsprüfung, zertifizierte Talente und berufliche Weiterbildung. 35 Tools. Null Abhängigkeiten. Kein API-Schlüssel.

npx -y tkawen

Warum es das gibt

Fragen Sie ein beliebiges Modell, wie viele Provinzen Algerien hat, und es wird Ihnen 58 sagen.

Algerien hat seit dem 16. November 2025 69 Wilayas, als elf delegierte Provinzen aufgewertet wurden. Fragen Sie nach den Gemeinden von Timimoun, und das Modell erfindet plausible arabische Ortsnamen. Fragen Sie, ob 0770112233 eine gültige algerische Nummer ist, und es rät.

Das ist keine Lücke, die ein größeres Modell schließt. Es ist ein Datenproblem, und das sind die Daten.

> 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

Installation

Fügen Sie es zur Konfiguration Ihres MCP-Clients hinzu:

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

Funktioniert mit Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Zed und allem anderen, das MCP über stdio spricht. Das ist die gesamte Installation — kein Konto, kein Schlüssel, keine Anmeldung.

🇩🇿 Die Algerien-Daten-API

Das Flaggschiff. Zwei Tools, die aus einem lokalen Datensatz antworten, sodass sie in Millisekunden reagieren und weiterarbeiten, selbst wenn alle anderen Dienste ausfallen.

algeria_geospatial

Lateinisch und Arabisch sind gleichberechtigt: Alger, الجزائر, الجزاير und alger führen alle zur Wilaya 16.

algeria_telecom_validator

Akzeptiert jedes Format, das ein Algerier tatsächlich schreibt — +213…, 00213…, 213…, nackte 9-stellige Nummern, Leerzeichen, Bindestriche und arabisch-indische Ziffern (٠٥٥٥١٢٣٤٥٦):

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

Mobilfunk (05 / 06 / 07) und Festnetzanschlüsse von Algérie Télécom (02 / 03) werden beide validiert.

Zwei Dinge wird es nicht tun, denn nützlich zu sein ist wichtiger als vollständig zu wirken:

• Der Betreiber ist die ursprüngliche Zuteilung. Nummernportabilität gilt in Algerien seit 2017, daher beweist 07 nicht mehr Djezzy. Wird als „ursprünglich zugeteilt“ gemeldet, nie als Tatsache.

• Festnetznummern werden keiner Wilaya zugeordnet. Algerische Vorwahlen folgen nicht der Wilaya-Nummerierung — Algier ist 021 in Wilaya 16, Oran 041 in Wilaya 31. Es gibt hier keine maßgebliche Vorwahltabelle, und eine zu erfinden würde erfundene Geografie in das Werkzeug einbauen, das Modelle davon abhalten soll, algerische Geografie zu erfinden.

Die anderen 33 Tools

Beginnen Sie mit tkawen_search_tools — beschreiben Sie, was Sie möchten, in einfachen Worten, und es gibt nur die passenden Tools zurück, anstatt 35 Schemata in Ihren Kontext zu laden. Es versteht Arabisch, Französisch und Englisch.

E-Commerce (MyStoq) — cod_profit (echter Nettogewinn inklusive Ablehnungsquote) · order_risk (COD-Betrugsbewertung) · yalidine_delivery (Retourenquoten und Lieferzeiten nach Wilaya) · search_stores · get_store · list_plans · platform_stats · create_store · create_product · set_price · publish · delete_product

Zertifikate (AlgeriaCertify) — verify_certificate · search_certified_talent · match_talent_to_job · get_talent_profile · list_specialties · list_institutions · platform_stats

Schulungen — search_trainings · get_training · list_categories · request_quote · list_individual_trainings · catalogue_stats

Besprechungen (LIQAA) — create_instant_room · list_plans · platform_capacity · platform_stats

Meta — tkawen_search_tools · tkawen_overview · tkawen_recommend · tkawen_verify

Echte Fragen, die diese beantworten:

Schreiben, nicht nur Lesen

Die meisten Tools sind schreibgeschützt und benötigen nichts. Diejenigen, die Dinge erstellen, agieren auf einem echten Konto und benötigen ein Token:

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

Ohne eines verweigern sie. Es wird nichts versehentlich erstellt.

Architektur

Eine Stdio-Brücke, ~190 Zeilen, zum TKAWEN Intelligence Gateway unter https://mcp.tkawen.com. Es lohnt sich, genau zu wissen, was das bedeutet:

• Ihre Fragen verlassen Ihren Rechner. Tool-Aufrufe gehen über HTTPS an mcp.tkawen.com. Wenn das für Ihre Daten nicht akzeptabel ist, installieren Sie es nicht. Das wird hier gesagt, statt es in einer Datenschutzseite zu verstecken.

• Die Tools sind nicht in diesem Paket. Sie leben auf dem Gateway, sodass ein am Dienstag hinzugefügtes Tool für Sie ohne Upgrade und ohne Versionsabweichung funktioniert.

• Null Abhängigkeiten. Nodes eingebautes fetch und sonst nichts — npx bleibt schnell, und es gibt keinen Abhängigkeitsbaum, der auf einem Pfad, der mit einer Live-API spricht, kompromittiert werden könnte.

• stdout trägt das Protokoll und sonst nichts. Ein einzelnes console.log beschädigt einen JSON-RPC-Stream und der Client meldet „Server getrennt“, ohne zu wissen warum. Jede Diagnose geht an stderr.

• Es scheitert korrekt. Gateway ausgefallen, Timeout, fehlerhafte Zeile, Nicht-JSON-Antwort: Sie erhalten einen ordnungsgemäßen JSON-RPC-Fehler und einen sauberen Exit, niemals einen Absturz oder einen beschädigten Stream. Jeder dieser Fälle ist ein Test.

Registriert im offiziellen MCP-Registry als com.tkawen/intelligence-gateway.

Konfiguration

Node 18+. Ältere Versionen haben kein globales fetch; die Brücke sagt das und beendet sich, anstatt auf eine Weise zu scheitern, die Sie debuggen müssten.

Tests

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

Die Unit-Tests laufen absichtlich gegen ein Mock-Gateway: Ein rotes test bedeutet, dass dieses Paket kaputt ist, und ein rotes smoke bedeutet, dass das Gateway nicht erreichbar ist. Wenn man die beiden zusammenführt, würde jeder Netzwerkausfall wie eine Code-Regression aussehen.

Lizenz

MIT — erstellt in Annaba von TKAWEN.