ALAPI

chính thức

ALAPI MCP Tools, gọi hàng trăm giao diện API qua MCP

GitHub
12

Bạn có thể làm gì với ALAPI MCP?

  • Tra cứu IP & tên miền — Yêu cầu thông tin định vị địa lý và chi tiết nhà cung cấp dịch vụ Internet của bất kỳ địa chỉ IPv4 hoặc IPv6 nào bằng ip_query.
  • Báo cáo thời tiết — Lấy điều kiện thời tiết hiện tại, cảnh báo, chỉ số chất lượng không khí (AQI) và dự báo cho các thành phố Trung Quốc qua weather_query.
  • Danh sách xu hướng nóng — Tìm nạp các chủ đề thịnh hành theo thời gian thực từ Weibo, Douyin, Toutiao, Zhihu, Baidu và 36Kr.
  • Xác minh công ty — Tra cứu thông tin đăng ký kinh doanh của Trung Quốc theo tên công ty hoặc mã số thống nhất tín dụng xã hội.
  • Theo dõi bưu kiện — Theo dõi trạng thái vận chuyển qua ZTO, STO, SF Express, J&T, Best, YTO và các hãng vận chuyển khác.
  • Kiểm duyệt nội dung — Kiểm tra văn bản vi phạm chính sách, phù hợp cho quy trình đánh giá đầu ra AI.

Tài liệu

🔥 Máy chủ ALAPI MCP

smithery badge License

Đây là một triển khai máy chủ MCP (Model Context Protocol) dựa trên ALAPI, cho phép gọi trực tiếp các giao diện của ALAPI thông qua giao thức MCP, dễ dàng tích hợp nguồn tài nguyên API phong phú của ALAPI vào các ứng dụng AI hỗ trợ MCP.

✨ Tính năng

  • 🔍 Nguồn API phong phú - Cung cấp hơn 100 dịch vụ API thường dùng như tra cứu IP, tra cứu thời tiết, bảng xếp hạng hot search, thông tin doanh nghiệp, v.v.
  • 🧩 Hỗ trợ giao thức MCP - Hoàn toàn tương thích với Model Context Protocol, dễ dàng tích hợp vào các ứng dụng AI.
  • 🔄 Tự động tải - Tự động tải đặc tả ALAPI OpenAPI, không cần cấu hình thủ công.
  • 🎯 Gọi linh hoạt - Hỗ trợ tải toàn bộ hoặc chỉ định API, sử dụng theo nhu cầu (phân tích video ngắn, tra cứu thời tiết, đọc hiểu thế giới trong 60 giây mỗi ngày, tra cứu doanh nghiệp, v.v.)
  • 🛡️ Phản hồi thống nhất - Cung cấp định dạng xử lý lỗi và phản hồi thống nhất, đơn giản hóa quy trình phát triển.
  • ⚙️ Khả năng cấu hình - Hỗ trợ cấu hình qua biến môi trường, dễ dàng thích ứng với các tình huống sử dụng khác nhau.

📖 Hướng dẫn sử dụng

Trước tiên cần tìm hiểu về giao thức MCP, sau đó thêm dịch vụ ALAPI MCP theo cấu hình dưới đây.

Sử dụng trong máy khách MCP

ALAPI MCP Server được thiết kế để sử dụng cùng các máy khách hỗ trợ giao thức MCP, không hỗ trợ cấu hình dòng lệnh độc lập. Vui lòng làm theo các bước sau để cấu hình sử dụng trong máy khách MCP của bạn:

Phương pháp 1: MCP từ xa

Dự án này hỗ trợ triển khai một chạm lên nền tảng phát triển đám mây Tencent, cung cấp truy cập SSE từ xa

☁️ Đến nền tảng phát triển đám mây để triển khai MCP Server

Phương pháp 2: Sử dụng Smithery để cài đặt tự động

Cài đặt ALAPI MCP Server thông qua Smithery, phù hợp với máy khách Claude Desktop:

npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude

Phương pháp 3: Sử dụng trực tiếp tệp nhị phân biên dịch sẵn (Khuyến nghị, không cần cài đặt phụ thuộc)

  1. Truy cập Trang Releases để tải xuống phiên bản mới nhất

    Địa chỉ tải xuống tăng tốc trong nước: https://cnb.cool/alapi/mcp-alapi-cn/-/releases

  2. Chọn phiên bản mới nhất tương ứng với hệ điều hành của bạn:

    • Windows: mcp-alapi-cn.exe
    • macOS: mcp-alapi-cn-macos
    • Linux: mcp-alapi-cn-linux

  3. Cấu hình trong máy khách hỗ trợ MCP (như Claude Desktop):

    • Mở cài đặt máy khách MCP
    • Thêm máy chủ MCP mới
    • Chỉ định đường dẫn tệp nhị phân đã tải xuống
    • Cấu hình các biến môi trường cần thiết (như ALAPI_TOKEN)

Cấu hình biến môi trường

ALAPI_TOKEN - Token truy cập nền tảng ALAPI (bắt buộc)

Cần cấu hình thành TOKEN bạn đã tạo trên nền tảng ALAPI, dùng để xác thực giao diện.

Ví dụ cấu hình máy khách MCP

Trong Claude Desktop hoặc các máy khách hỗ trợ MCP khác, có thể tham khảo cấu hình sau:

Cấu hình JSON (sử dụng tệp nhị phân cục bộ)

{
  "mcpServers": {
    "alapi": {
      "path": "/path/to/mcp-alapi-cn",
      "env": {
        "ALAPI_TOKEN": "在 ALAPI 平台申请创建的 token"
      }
    }
  }
}

Các máy khách MCP được hỗ trợ

Theo tài liệu MCP, các máy khách sau hỗ trợ tích hợp công cụ MCP:

  • Claude Desktop App
  • Claude Code
  • Cursor
  • Continue
  • Cline
  • và các máy khách khác hỗ trợ giao thức MCP

Lưu ý: Đảm bảo máy khách MCP của bạn hỗ trợ tính năng tích hợp công cụ, vui lòng tham khảo tài liệu cụ thể của từng máy khách để cấu hình.

🛠️ Chức năng được hỗ trợ

Dưới đây là một số chức năng được hỗ trợ, chức năng đầy đủ vui lòng tham khảo thực tế khi gọi:

Tên chức năngMô tả
Tra cứu IPTra cứu thông tin vị trí IP, hỗ trợ IPv4 và IPv6
Tra cứu thời tiếtTra cứu chi tiết thời tiết trong nước, bao gồm thông tin thời tiết, cảnh báo thời tiết, chỉ số thời tiết, AQI, v.v.
Bảng hot hôm nayTra cứu dữ liệu bảng hot hôm nay, bao gồm hot search Douyin, bảng hot Toutiao, Zhihu, 36k, hot search Baidu, hot search Weibo, v.v.
Kiểm duyệt văn bảnTra cứu xem văn bản có vi phạm không, đặc biệt phù hợp kiểm duyệt nội dung AI
URL rút gọnRút gọn URL dài thành URL ngắn, tiện cho việc gửi SMS, tạo mã QR, v.v.
Nhận dạng mã QRHỗ trợ nhiều mã trong một ảnh, hỗ trợ nhận dạng mã QR, mã vạch
Ngày này năm xưaTra cứu sự kiện lớn xảy ra vào ngày được chỉ định trong lịch sử
Tra cứu tỷ giáTra cứu tỷ giá và quy đổi tiền tệ theo mã tiền tệ, hỗ trợ tra cứu hơn 170 quốc gia và vùng lãnh thổ toàn cầu
Tra cứu doanh nghiệpTra cứu thông tin công thương cơ bản của doanh nghiệp theo tên doanh nghiệp hoặc mã số tín dụng xã hội thống nhất
Tra cứu chuyển phátTra cứu miễn phí lộ trình chuyển phát nhanh, hỗ trợ ZTO, STO, SF, J&T, Best, YTO, v.v.
Tử vi cung hoàng đạoCung cấp dịch vụ tra cứu tử vi cung hoàng đạo, hỗ trợ tra cứu tử vi hôm nay hoặc ngày mai, tuần này, tháng này, năm nay của 12 cung hoàng đạo
Giá vàngTra cứu giá vàng thời gian thực hiện tại, giá cao nhất, giá thấp nhất, giá vàng thương hiệu

🔗 Liên kết liên quan

🙏 Cảm ơn