tkawen

알제리를 위한 MCP 서버. 모든 AI 어시스턴트를 위한 실제 알제리 데이터 — 전체 69개 윌라야(wilaya), 1,581개 코뮌(commune), 전화번호 검증, 전자상거래, 착불 경제, 자격증 검증, 인증된 인재 및 전문 교육. 35개 도구. 제로 의존성. API 키 불필요.

npx -y tkawen

왜 존재하는가

아무 모델에게 알제리에 몇 개의 주가 있는지 물어보면 58이라고 답할 것입니다.

알제리는 2025년 11월 16일부터 69개 윌라야를 보유하고 있습니다. 이때 11개의 위임 주(州)가 승격되었습니다. Timimoun의 코뮌을 물어보면 모델은 그럴듯한 아랍어 지명을 지어냅니다. 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 및 stdio를 통해 MCP를 지원하는 모든 도구에서 작동합니다. 이것이 설치의 전부입니다 — 계정도, 키도, 가입도 필요 없습니다.

🇩🇿 The Algeria Data 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를 증명하지 않습니다. "원래 할당된 통신사"로 보고되며, 결코 사실로 보고되지 않습니다.

• 유선전화는 윌라야에 매핑되지 않습니다. 알제리의 지역 번호는 윌라야 번호 체계를 따르지 않습니다 — Algiers는 윌라야 16에서 021, Oran은 윌라야 31에서 041입니다. 여기에는 공신력 있는 지역 번호 표가 없으며, 하나를 지어내면 모델이 알제리 지리를 지어내는 것을 막기 위해 만든 도구 안에 가짜 지리를 넣는 셈이 됩니다.

나머지 33개 도구

**tkawen_search_tools**부터 시작하세요 — 원하는 것을 평이한 말로 설명하면 35개 스키마를 컨텍스트에 로드하는 대신 조건에 맞는 도구만 반환합니다. 아랍어, 프랑스어, 영어를 이해합니다.

전자상거래 (MyStoq) — cod_profit (거부율을 포함한 실제 순이익) · order_risk (COD 사기 점수) · 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" }
    }
  }
}

토큰이 없으면 거부합니다. 실수로 생성되는 것은 없습니다.

아키텍처

https://mcp.tkawen.com의 TKAWEN Intelligence Gateway로 연결되는 stdio 브리지, ~190줄입니다. 이것이 정확히 무엇을 의미하는지 알아둘 가치가 있습니다:

• 질문이 사용자의 컴퓨터를 떠납니다. 도구 호출은 HTTPS를 통해 mcp.tkawen.com으로 전송됩니다. 데이터에 대해 이것이 허용되지 않는다면 설치하지 마세요. 개인정보 보호 페이지에 묻어 두지 않고 여기서 명확히 말합니다.

• 도구는 이 패키지에 포함되어 있지 않습니다. 도구는 게이트웨이에 있으므로 화요일에 추가된 도구는 업그레이드나 버전 불일치 없이 바로 작동합니다.

• 제로 의존성. Node의 내장 fetch만 사용하고 그 외에는 아무것도 없습니다 — npx는 빠르게 유지되며, 실시간 API와 통신하는 경로에서 공격받을 의존성 트리도 없습니다.

• stdout은 프로토콜만 전달하고 그 외에는 아무것도 전달하지 않습니다. 하나의 잘못된 console.log가 JSON-RPC 스트림을 손상시키고 클라이언트는 이유를 알 수 없는 "server disconnected"를 보고합니다. 모든 진단 정보는 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

단위 테스트는 의도적으로 모의 게이트웨이를 대상으로 실행됩니다. test가 빨간색이면 이 패키지가 고장난 것이고, smoke가 빨간색이면 게이트웨이에 연결할 수 없다는 뜻입니다. 둘을 합치면 모든 네트워크 일시 장애가 코드 회귀로 보일 것입니다.

라이선스

MIT — Annaba에서 TKAWEN이 제작.