德铁信可MCP跟踪器
这个项目是一个 MCP（模型上下文协议）服务器 该系统通过拦截来自德铁信可公共网站的内部跟踪数据来跟踪德铁信克的货物。\ 它使用 剧作家 运行无头浏览器并捕获通过传统抓取或简单HTTP请求无法获得的详细发货信息。
该工具可以是：
- 作为MCP服务器运行，以便与 克劳德桌面版
- 通过终端脚本进行本地测试
关于如何设置和测试该工具的说明
首先，你需要安装Python 3.10或更高版本。 您必须使用Python MCP SDK 1.2.0或更高版本。
安装uv
macOS/Linux： curl -LsSf https://astral.sh/uv/install.sh | sh
窗户： powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
克隆仓库
git clone https://github.com/Josefgus/schenker-tracker
cd schenker-tracker
uv sync
安装无头浏览器
uv run playwright install chromium
启动MCP服务器
uv run python schenker_server.py
在终端进行测试
uv run python shenker_terminal.py
使用Claude for Desktop进行测试
安装最新版本的claude桌面https://claude.com/download
运行克劳德
打开应用程序配置 ~/Library/Application Support/Claude/claude_desktop_config.json （适用于macOS/linux）
或
AppData\Claude\claude_desktop_config.json （适用于Windows）
添加我们的mcp服务器，如下所示：
{
"mcpServers": {
"schenker_tracker": {
"command": "uv",
"args": [
"--directory",
"C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\SCHENKER-TRACKER",
"run",
"schenker_server.py"
]
}
}
}您可能需要在命令字段中输入uv可执行文件的完整路径。您可以通过在macOS/Linux上运行which uv或在Windows上运行where uv来获得此信息。
重新启动Claude，应该会检测到mcp服务器，然后您可以要求跟踪包的更新。
如何测试该工具
要在终端中测试该工具，请运行脚本schenker_terminal.py 输入参考号，等待终端打印响应。（例如“1806203236”）。
终端上打印的是所有相关信息，并给出参考号。
我是如何从schenker中提取数据的？
项目的初步探索。
我首先手动检查了DB Schenker的公共跟踪门户，以查看哪些数据是可见的，以及如何获取这些数据。我使用浏览器开发工具分析网络流量和网站结构，以找到信息的来源。我很快意识到，标准的GET或POST请求是行不通的，因为该网站是一个依赖于客户端JavaScript显示数据的现代应用程序。该网站还使用Cookie和验证码等安全检查来阻止自动抓取。为了解决JavaScript和安全问题，我决定使用Playwright的无头浏览器。这允许脚本在没有GUI的情况下运行完整的浏览器，并像真实用户一样执行所有JavaScript。它还自动处理Cookie和会话。我向人工智能寻求帮助，集思广益，找出捕捉后台网络请求的方法，最终找到了解决方案。
我想跟踪每个包裹，但我被困住了。我使用的瑞典网站没有包括这些数据。经过一番谷歌搜索，我终于登陆了美国网站，我看到美国版本的跟踪应用程序提供了更多的信息。我分析了美国网站的背景流量，发现了一个包含我所需详细数据的特定JSON响应。我更新了代码，使用国际跟踪URL并拦截原始JSON数据，而不是从屏幕上抓取文本。这使得数据非常准确。该工具现在为装运中的每个包裹提供完整的装运历史和特定的状态更新。