返回 MCP 目录
public公开dns本地运行

ShippingTracker

一个基于SweetTracker API的韩国快递查询MCP服务器,提供快递公司列表查询和运单号追踪功能。

article

README

🚀 ShippingTracker MCP Server

这是一个用于查询韩国快递配送信息的MCP(Model Context Protocol)服务器。它借助SweetTracker API来查询快递公司列表和运单号信息。

🚀 快速开始

本地开发

  1. 克隆仓库
git clone https://github.com/gws8820/shippingtracker.git
cd shippingtracker
  1. 设置环境变量
echo "SWEETTRACKER_API_KEY=YOUR_API_KEY" > .env
  1. 运行项目
uv run python -m shippingtracker.main

# 或者使用uvx运行
uvx --from . shippingtracker

与Claude Desktop连接

请将Claude Desktop的配置文件(claude_desktop_config.json)设置如下:

{
  "mcpServers": {
    "shippingtracker": {
      "command": "uvx",
      "args": ["shippingtracker"],
      "env": {
        "SWEETTRACKER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

✨ 主要特性

  • get_company_list():查询支持的快递公司列表
  • track_shipping(company_code, tracking_invoice):查询配送信息

📦 安装指南

前置要求

📄 许可证

本项目根据MIT许可证进行分发。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端