ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว เข้าสู่ระบบ

Sudan Atlas

โดย aminshennanรุ่น 0.1.4i★ 0iรันบนคลาวด์เว็บทางการ ↗
ชื่อใน registryio.github.aminshennan/sudan-atlas

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ คลาวด์ (ต่อผ่านอินเทอร์เน็ต)
  • บัญชีหรือคีย์ ไม่ต้องใส่คีย์
  • หมวด เที่ยว แผนที่ และอากาศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Match Sudanese place names (Arabic or English) to official P-codes; get places and boundaries.

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม0/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ8/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน20/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Sudan Atlas ให้หน่อย ทำตาม https://mcp.popnx.com/i/aminshennan-sudan-atlas.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (atlas-sudan.vercel.app) · ✓ ตรวจคำสั่งแล้ว 20 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม

  1. เปิดหน้า Connectors ของ Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้

    คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue

    Name · ชื่อSudan Atlas
    Remote MCP server URL · ที่อยู่https://atlas-sudan.vercel.app/api/mcp

    กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add

  3. เปิดใช้ในแชต

    +ConnectorsSudan Atlas

  4. ลองเลย

    ใช้ Sudan Atlas บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Sudan Atlas หรือมีชื่อเครื่องมือของ Sudan Atlas ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ ChatGPT ได้ ขึ้นกับแผน

MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น

  1. เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. กรอกชื่อและที่อยู่

    ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin

    Name · ชื่อSudan Atlas
    Connection · ที่อยู่https://atlas-sudan.vercel.app/api/mcp
  3. เลือก Sudan Atlas ในแชต

    เปิดแชตใหม่แล้วเลือก Sudan Atlas จากรายการปลั๊กอินก่อนพิมพ์

  4. ลองเลย

    ใช้ Sudan Atlas บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า ChatGPT บอกว่ากำลังใช้ Sudan Atlas หรือมีชื่อเครื่องมือของ Sudan Atlas ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Claude Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  2. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --transport http --scope user sudan-atlas https://atlas-sudan.vercel.app/api/mcp
  3. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Sudan Atlas ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  4. ลองเลย

    ใช้ Sudan Atlas บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Sudan Atlas หรือมีชื่อเครื่องมือของ Sudan Atlas ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน Cursor โหมด Agent

  3. ลองเลย

    ใช้ Sudan Atlas บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Sudan Atlas หรือมีชื่อเครื่องมือของ Sudan Atlas ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน VS Code โหมด Agent

  3. ลองเลย

    ใช้ Sudan Atlas บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Sudan Atlas หรือมีชื่อเครื่องมือของ Sudan Atlas ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ

ที่อยู่https://atlas-sudan.vercel.app/api/mcp

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Sudan Atlas อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ต่อผ่านเว็บ

Claude Code

claude mcp add --transport http --scope user sudan-atlas https://atlas-sudan.vercel.app/api/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "sudan-atlas": {
      "url": "https://atlas-sudan.vercel.app/api/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "sudan-atlas": {
      "type": "http",
      "url": "https://atlas-sudan.vercel.app/api/mcp"
    }
  }
}

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
การเชื่อมต่อ
รันบนคลาวด์
รุ่นล่าสุดi
0.1.4
ส่งเข้า registryi
20 พ.ย. 2569
แก้โค้ดล่าสุดi
20 พ.ย. 2569
ตรวจล่าสุดเมื่อ
20 พ.ย. 2569
ผู้ทำ
aminshennan
เว็บผู้ทำ
atlas-sudan.vercel.app
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ต่อผ่านคลาวด์ได้ใน

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 20 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน

  • match_place_name

    Match one state or locality name, in Arabic or English and any spelling, to its official P-code. Returns pcode (null when not confident), names, score 0-1, method (exact, variant, fuzzy, ambiguous, none) and up to three alternatives.

  • match_place_names

    Match up to 1,000 names at once (for example a spreadsheet column). Each item can carry its own state hint. Results are in the same order as the input.

  • search_places

    Find states and localities whose official English or Arabic name contains the text, best first, with the matcher's answer for misspellings.

  • get_place

    Official names, level, parent state, localities (for a state), area in km² and estimated population (COD-PS 2025, mid-2025) for a P-code.

  • list_places

    All 19 admin-1 units (18 states and the Abyei PCA area), or the localities of the whole country or of one state.

  • get_boundary

    The boundary as a GeoJSON Feature (EPSG:4326) with the place's properties. 'light' is small and enough for most maps; 'medium' is more detailed.

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 21 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub aminshennan ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด เมื่อวาน

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ MIT

  • ✓ ผ่าน

    endpoint ตอบ

    ตอบกลับใน 749 ms (HTTP 200)

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ไม่ต้องล็อกอิน

  • ✓ ผ่าน

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    อ่านคำอธิบายเครื่องมือ 6 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/aminshennan-sudan-atlas.svg?lang=th)](https://mcp.popnx.com/th/servers/aminshennan-sudan-atlas)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด เที่ยว แผนที่ และอากาศi

  • ดาวมากกว่า 0% ของอีก 2083 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 99% ของอีก 2083 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 2083 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Sudan Atlas ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวาน และส่งรุ่นล่าสุด (0.1.4) เข้า registry เมื่อวาน

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

โดย microกำลังโต★ 441อัปเดต 4 เดือนที่ผ่านมา

รันบนคลาวด์✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

โดย AwardTravelFinderเริ่มต้น★ 16อัปเดต 3 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · awardtravelfinder.com

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

โดย tengolabsเริ่มต้น↓ 328/สัปดาห์★ 14อัปเดต 14 วันที่ผ่านมา

รันบนเครื่อง✓ เจ้าของบริการ · killbottleneck.com

Gondola Award Travel Search

Compare cash vs points on hotels, flights, and cars. Checkout supported hotels and rental cars.

โดย gondola-aiเริ่มต้น★ 11อัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · gondola.ai

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

โดย WhimsicalCodeเริ่มต้น★ 11อัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · whimsical.com
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Sudan Atlas
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
ทำงานที่ไหนใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องต้องลงในเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่อง
ต้องใส่คีย์ไม่ไม่ไม่ใช่ไม่ไม่
กด + ใน Claude ได้ไม่ไม่ไม่ไม่ไม่ใช่
ผลตรวจเบื้องต้น5/54/43/33/34/44/4
สัญญาอนุญาตMITAGPL-3.0MITMITMITMIT
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Sudan Atlas toolkit

An open toolkit that turns messy Sudanese place names into official codes, and gives the names (Arabic and English) and boundaries of Sudan's 18 states, the Abyei PCA area and 189 localities. It contains:

  • Python and JavaScript packages (sudan-atlas on PyPI and npm) with the same matcher, data and results;
  • the data: boundaries following OCHA's COD-AB for Sudan (v03), a gazetteer of reviewed spellings, and the pipeline that builds them;
  • a skill for AI assistants, and a Claude Code plugin that adds it together with the Sudan Atlas MCP server;
  • an evaluation of the matcher on real humanitarian data.

Status: packages 0.1.4 on npm and PyPI; data release 2026.1 (COD-AB Sudan v03).

Use it online: the website atlas-sudan.vercel.app is built on this toolkit: a map of every state and locality, a map-maker that turns a spreadsheet of place names into a map (in the browser; files never leave your device), and the documentation.

Quick start

JavaScript (npm install sudan-atlas)

import { match, getFeature } from "sudan-atlas";

match("El Hasaheesa", { stateHint: "Al Gezira", level: 2 }).pcode; // "SD15034" const shape = await getFeature("SD15034", "medium"); // GeoJSON Feature

Python (pip install sudan-atlas, or "sudan-atlas[geo]" for GeoDataFrames)

from sudan_atlas import match, get_localities

match("الفاشر", level=2)["pcode"] # 'SD02114' get_localities("SD15") # the localities of Aj Jazirah

In a browser with no build step: import { match } from "https://cdn.jsdelivr.net/npm/sudan-atlas@0.1/dist/index.js"; the data files are on jsDelivr too, under …/sudan-atlas@0.1/data/.

AI assistants: in Claude Code, add the plugin, which brings the skill and the MCP server:

/plugin marketplace add aminshennan/sudan-atlas

/plugin install sudan-atlas@sudan-atlas

Or add the server alone, in any client that supports remote MCP servers: claude mcp add --transport http sudan-atlas https://atlas-sudan.vercel.app/api/mcp. The skill works in other agents too: copy plugins/sudan-atlas/skills/sudan-atlas/ into the agent's skills folder. Names sent to the MCP server are processed on the server and not stored; each address may make 60 requests a minute.

Examples: a D3 choropleth from a messy spreadsheet, a state-and-locality picker, and a Python notebook.

What a match returns

{

pcode: "SD15034", name_en: "Al Hasahisa", name_ar: "الحصاحيصا", level: 2, score: 0.9, // 0 to 1 method: "fuzzy", // exact, variant or fuzzy; ambiguous or none when there is no match alternatives: [ ... ] // the next three candidates, each with pcode, names, level and score }

When the best candidate scores below 0.82, or another place scores almost as high, pcode is null (None in Python) and alternatives lists the candidates: the matcher never guesses silently. "Gallabat" lies on a locality border and "Abyei" can mean the Abyei PCA area or the West Kordofan locality, so both come back as ambiguous for a person to decide. A state hint (a P-code or a state name in any spelling) and a level (1 = state, 2 = locality) settle most ambiguity.

We tested the matcher on 299 place names copied from eight public HDX datasets (UNHCR refugee sites, OCHA people reached and 3W, IOM DTM, IPC, schools, floods and population tables): 253 that should match a state or locality and 46 that should match nothing (camps, villages, names shared by several places, header and total rows). With a state hint, it finds the right place first time for 94.9 % of the 253, puts it among the top three for 99.6 %, and named no wrong place for any of the 299. Without a state hint: 85.0 % first time and 2.3 % wrong matches. The threshold was chosen on this same set, so these figures describe it rather than an independent test, and new data will produce some wrong matches; please report them. Details and every failure: docs/MATCHER_EVALUATION.md. The Python and JavaScript packages share the same rules and return identical results.

What it does

  • Name matching: El Fasher, Al Fashir and الفاشر all resolve to the same official P-code, with a confidence score and alternatives.
  • Boundaries: states (admin 1) and localities (admin 2) as GeoJSON and TopoJSON at three resolutions, following OCHA's COD-AB exactly.
  • Bilingual: every feature carries pcode, name_en and name_ar.
  • Runs on your machine: the packages ship the data as files and match locally, with no network calls (boundaries can also be loaded from a CDN in the browser).

Repository layout

data/          boundaries, gazetteer and test cases (one source of truth)

pipeline/ Python scripts that rebuild data/ from data/raw/ packages/js/ npm package: data + matcher (TypeScript) packages/py/ PyPI package: same API (Python) plugins/ Claude Code plugin: the skill plus the MCP server examples/ D3 map, dropdown form, Python notebook docs/ DATA_POLICY.md, SOURCES.md, GAZETTEER.md, MATCHER_EVALUATION.md

Citing Sudan Atlas

If you use Sudan Atlas in a report, paper or product, please cite it:

Shennan, A. (2026). *Sudan Atlas: official names, P-codes and boundaries for Sudan's states and localities*. Zenodo. https://doi.org/10.5281/zenodo.24191931

Each GitHub release is archived on Zenodo; the "Cite this repository" button on GitHub gives the citation in APA and BibTeX, from CITATION.cff. Please also credit the boundary source: "OCHA (COD-AB Sudan), via HDX".

Help improve it

Found a spelling the matcher misses, or a name that should match differently? Open an issue with the name as written and the place it refers to. Every new spelling is reviewed before it is added.

Licence

  • Code: MIT
  • Boundaries: CC BY 3.0 IGO, derived from OCHA's COD-AB (details)
  • Gazetteer additions (variant spellings, normalisation rules, test cases): CC BY 4.0
  • OpenStreetMap town spellings: ODbL 1.0, © OpenStreetMap contributors. They are kept in their own file (variants_osm.json), so the ODbL covers that file only, not the other data or your matching results (details)
  • Sources are listed in docs/SOURCES.md. Boundary choices are documented in docs/DATA_POLICY.md.

Boundaries are shown for humanitarian, research and practical use and do not imply any opinion on the legal status of any territory.

Made by Amin Shennan.