IP2Location.io MCP Server

เซิร์ฟเวอร์ IP2Location.io MCP

นี่คือการใช้งานเซิร์ฟเวอร์ Model Context Protocol (MCP) อย่างง่ายสำหรับ IP2Location.io API โดยจะส่งคืนข้อมูลตำแหน่งทางภูมิศาสตร์โดยละเอียดสำหรับที่อยู่ IPv4 หรือ IPv6 ใดๆ ที่กำหนดให้

คุณสมบัติ

• ข้อมูลตำแหน่งทางภูมิศาสตร์ที่ครอบคลุม: ดึงข้อมูลที่หลากหลาย รวมถึงประเทศ ภูมิภาค เมือง ละติจูด ลองจิจูด รหัสไปรษณีย์ เขตเวลา และอื่นๆ
• รายละเอียดเครือข่าย: ให้ข้อมูลที่เกี่ยวข้องกับเครือข่าย เช่น ASN, ISP, โดเมน และความเร็วเครือข่าย
• ข้อมูลเชิงลึกด้านความปลอดภัย: ตรวจจับข้อมูลพร็อกซี รวมถึงประเภทพร็อกซีและผู้ให้บริการ
• การผสานรวมที่ง่าย: สร้างขึ้นเป็นเครื่องมือ FastMCP ทำให้สามารถผสานรวมเข้ากับระบบที่เข้ากันได้อย่างง่ายดาย
• แบบอะซิงโครนัส: ใช้ httpx สำหรับคำขอ API แบบอะซิงโครนัสที่ไม่บล็อก

ข้อกำหนด

เซิร์ฟเวอร์ MCP นี้รองรับการค้นหาโดยไม่ต้องใช้คีย์ API โดยจำกัดที่ 1,000 คำขอต่อวัน คุณยังสามารถ ลงทะเบียน เพื่อรับคีย์ API ฟรีและเพลิดเพลินกับคำขอสูงสุด 50,000 คำขอต่อเดือน

หากคุณใช้เซิร์ฟเวอร์ MCP ที่โฮสต์บนคลาวด์ คุณเพียงแค่ต้องมี Claude Desktop และ npx เนื่องจากเซิร์ฟเวอร์ถูกโฮสต์จากระยะไกล หากคุณต้องการเรียกใช้เซิร์ฟเวอร์ MCP ต้นฉบับในเครื่อง การตั้งค่าในเครื่องจะใช้ uv ซึ่งสามารถติดตั้งได้โดยทำตาม คำแนะนำ

การตั้งค่า

คุณสามารถใช้เซิร์ฟเวอร์ MCP นี้ใน Claude Desktop ได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้:

• เซิร์ฟเวอร์ MCP ที่โฮสต์บนคลาวด์: แนะนำหากคุณต้องการเชื่อมต่อโดยตรงกับเซิร์ฟเวอร์ IP2Location.io MCP ที่โฮสต์ไว้
• เซิร์ฟเวอร์ MCP ในเครื่อง: ใช้ตัวเลือกนี้หากคุณต้องการดาวน์โหลดและเรียกใช้เซิร์ฟเวอร์ MCP ต้นฉบับบนเครื่องของคุณเอง

ตัวเลือกที่ 1: เซิร์ฟเวอร์ MCP ที่โฮสต์บนคลาวด์

ทำตามขั้นตอนด้านล่างเพื่อใช้เซิร์ฟเวอร์ IP2Location.io MCP ที่โฮสต์บนคลาวด์กับ Claude Desktop:

1. ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้ง Claude Desktop แล้ว หากคุณยังไม่ได้ติดตั้ง ให้ดาวน์โหลดจาก ที่นี่ สำหรับ Windows และ macOS หรือทำตาม คำแนะนำนี้ สำหรับผู้ใช้ Linux
2. เปิดไฟล์ claude_desktop_config.json ในโปรแกรมแก้ไขที่คุณเลือก หากคุณยังไม่มี ให้ทำตาม คำแนะนำนี้ เพื่อสร้างขึ้นมา
3. เพิ่มสิ่งต่อไปนี้ลงใน claude_desktop_config.json ของคุณ:

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

4. แทนที่ YOUR_API_KEY ด้วยคีย์ API IP2Location.io จริงของคุณ หากต้องการรับคีย์ API ของคุณ ให้ เข้าสู่ระบบ ไปยังแดชบอร์ดของคุณ
5. รีสตาร์ท Claude Desktop หลังจากบันทึกการเปลี่ยนแปลง และคุณควรเห็นเซิร์ฟเวอร์ MCP ปรากฏในเมนู Connectors

ตัวเลือกที่ 2: เซิร์ฟเวอร์ MCP ในเครื่อง

ทำตามขั้นตอนด้านล่างหากคุณต้องการเรียกใช้เซิร์ฟเวอร์ MCP ต้นฉบับในเครื่องกับ Claude Desktop:

1. ตั้งค่าตัวจัดการแพ็คเกจ uv คุณสามารถอ้างอิง คำแนะนำ เพื่อดำเนินการดังกล่าว
2. ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้ง Claude Desktop แล้ว หากคุณยังไม่ได้ติดตั้ง ให้ดาวน์โหลดจาก ที่นี่ สำหรับ Windows และ macOS หรือทำตาม คำแนะนำนี้ สำหรับผู้ใช้ Linux
3. เปิดไฟล์ claude_desktop_config.json ในโปรแกรมแก้ไขที่คุณเลือก หากคุณยังไม่มี ให้ทำตาม คำแนะนำนี้ เพื่อสร้างขึ้นมา
4. เพิ่มสิ่งต่อไปนี้ลงใน claude_desktop_config.json ของคุณ:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

5. หากต้องการรับคีย์ API ของคุณ ให้ เข้าสู่ระบบ ไปยังแดชบอร์ดของคุณ แทนที่ <YOUR API key HERE> ในตัวอย่างด้านบนด้วยคีย์ API จริงของคุณ
6. รีสตาร์ท Claude Desktop หลังจากบันทึกการเปลี่ยนแปลง และคุณควรเห็นมันปรากฏในเมนู Connectors

การใช้งาน

เพียงป้อนคำถามของคุณเกี่ยวกับ IP ในการแชทใน Claude Desktop ตัวอย่างคำถามบางส่วนจะเป็น:

• ตำแหน่งของ (IP) อยู่ที่ไหน?
• (IP) ตั้งอยู่ที่ไหน?
• พิกัดของ (IP) คืออะไร?

ตัวอย่างเช่น ด้านล่างนี้คือผลลัพธ์ของ IP 8.8.8.8:

ใน Claude Desktop โมเดลจะสร้างผลลัพธ์โดยอัตโนมัติตามผลลัพธ์ที่ส่งคืนโดยเซิร์ฟเวอร์ IP2Location.io MCP

คุณยังสามารถใช้ IP2Location.io Bulk IP Geolocation API เพื่อค้นหาที่อยู่ IP หลายรายการ เพียงป้อนที่อยู่ IP ทั้งหมดโดยเว้นวรรคระหว่างแต่ละที่อยู่ IP ตัวอย่างเช่น 8.8.8.8 8.8.6.6

[!NOTE]
IP2Location.io Bulk IP Geolocation API ต้องใช้แผนแบบชำระเงินจึงจะทำงานได้

ตัวแปรสภาพแวดล้อม

IP2LOCATION_API_KEY

คีย์ API IP2Location.io ซึ่งช่วยให้คุณค้นหาได้สูงสุด 50,000 คำขอต่อเดือนและรายละเอียดเพิ่มเติมของที่อยู่ IP คุณสามารถ ลงทะเบียน เพื่อรับคีย์ API ฟรี หรือ สมัครสมาชิก แผนเพื่อรับสิทธิประโยชน์เพิ่มเติม

เครื่องมือ

get_geolocation

คำอธิบาย ดึงข้อมูลตำแหน่งทางภูมิศาสตร์สำหรับที่อยู่ IP ที่กำหนดหรือชุดของที่อยู่ IP ช่วยให้ผู้ใช้ดึงข้อมูลโดยละเอียด เช่น ประเทศ ภูมิภาค เมือง ละติจูด ลองจิจูด รหัสไปรษณีย์ เขตเวลา ASN และข้อมูลพร็อกซีสำหรับที่อยู่ IPv4 หรือ IPv6 ใดๆ มันจะกำหนดเส้นทางคำขอไปยัง IP2Location.io Bulk API โดยอัตโนมัติเพื่อการประมวลผลที่มีประสิทธิภาพเมื่อตรวจพบ IP หลายรายการ

อาร์กิวเมนต์

• ip (str): ที่อยู่ IP (IPv4 หรือ IPv6) ที่จะวิเคราะห์ คุณสามารถค้นหา IP หลายรายการพร้อมกันได้โดยส่งเป็นสตริงเดียวที่คั่นด้วยเครื่องหมายจุลภาค ช่องว่าง หรือขึ้นบรรทัดใหม่ (เช่น "1.1.1.1, 2.2.2.2")

ส่งคืน สตริง JSON ที่มีข้อมูลตำแหน่งทางภูมิศาสตร์ หากมีการค้นหา IP หลายรายการ มันจะส่งคืนออบเจ็กต์ JSON ที่แต่ละคีย์เป็นที่อยู่ IP ที่แมปกับข้อมูลของมัน ผลลัพธ์อาจรวมถึงฟิลด์ต่อไปนี้ ขึ้นอยู่กับแผน API ของคุณ:

• ตำแหน่งและภูมิศาสตร์: ประเทศ ภูมิภาค เขต เมือง รหัสไปรษณีย์ ละติจูดและลองจิจูด เขตเวลา
• เครือข่ายและการเชื่อมต่อ: ASN (หมายเลขระบบอัตโนมัติ), ISP (ผู้ให้บริการอินเทอร์เน็ต), โดเมน, ความเร็วเน็ต, รหัส IDD, รหัสพื้นที่, ประเภทที่อยู่, ประเภทการใช้งาน
• ข้อมูลมือถือ: MNC (รหัสเครือข่ายมือถือ), MCC (รหัสประเทศมือถือ), แบรนด์มือถือ
• สกุลเงินและภาษา: รหัสสกุลเงิน, ชื่อสกุลเงิน, สัญลักษณ์สกุลเงิน, รหัสภาษา, ชื่อภาษา
• พร็อกซีและความปลอดภัย: ประเภทพร็อกซี, เห็นล่าสุด, ระดับ/ประเภทภัยคุกคาม, ผู้ให้บริการพร็อกซี, คะแนนการฉ้อโกง
• อื่นๆ: หมวดหมู่ IAB, สภาพอากาศ, ระดับความสูง, ประชากร และอื่นๆ

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

ใบอนุญาต

ดูไฟล์ LICENSE