内容
# nexusfeed-mcp
[](https://pypi.org/project/nexusfeed-mcp/)
[](https://www.python.org/downloads/)
[](LICENSE)
实时LTL货运燃油附加费率和美国州ABC酒类许可合规记录 — 通过模型上下文协议以规范化、可验证的JSON格式提供给AI代理。
数据从承运商的资费页面和州ABC门户（JS渲染、CAPTCHA、会话状态）中提取，这些页面在结构上对原始LLM浏览不可访问。每个响应都包含一个 `_verifiability` 块 — 提取时间戳、置信度得分和源URL — 以便代理在采取行动之前评估数据质量。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `ltl_get_fuel_surcharge` | ODFL、Saia、Estes、ABF、R+L、TForce、XPO、SEFL、Averitt的每周燃油附加费百分比 - DOE柴油价格和最多5年的历史记录 |
| `ltl_list_carriers` | 承运商覆盖范围元数据（SCAC代码、更新计划、提取方法） |
| `abc_search_licenses` | 按贸易名称、所有者或地址搜索CA、TX、NY、FL许可数据库 |
| `abc_lookup_license` | 按州颁发的许可号查询许可状态 |
| `abc_list_states` | 状态覆盖范围、延迟和CAPTCHA要求 |
## 工作流提示
| 提示 | 描述 |
|--------|-------------|
| `freight_audit_workflow` | 对发布的承运商资费的多步骤LTL发票审计 |
| `license_compliance_check` | 分销商订单、保险绑定或商家入驻前的合规性验证 |
## 获取API访问权限
通过RapidAPI订阅以接收您的`X-API-Key`。提供免费增值计划（每天10个请求免费）。
| 产品 | RapidAPI列表 |
|---------|-----------------|
| **LTL燃油附加费** | [rapidapi.com/ladourv/api/ltl-fuel-surcharge-api](https://rapidapi.com/ladourv/api/ltl-fuel-surcharge-api) |
| **ABC许可合规** | [rapidapi.com/ladourv/api/abc-license-compliance-api](https://rapidapi.com/ladourv/api/abc-license-compliance-api) |
## 安装
```bash
pip install nexusfeed-mcp
# 或使用uv/uvx（无需安装）：
uvx nexusfeed-mcp
```
## 配置
```bash
export MCP_API_BASE_URL=https://api.nexusfeed.dev
export MCP_API_KEY=sk_live_your_key_here
```
## 运行（标准输入）
```bash
# 仅限LTL工具 - 3种工具，1个提示
nexusfeed-ltl
# 仅限ABC工具 - 3种工具，1个提示
nexusfeed-abc
# 所有工具 - 5种工具，2个提示
nexusfeed-mcp
```
## Claude桌面配置
**仅限LTL燃油附加费：**
```json
{
"mcpServers": {
"nexusfeed-ltl": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
**仅限ABC许可合规：**
```json
{
"mcpServers": {
"nexusfeed-abc": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
**所有工具：**
```json
{
"mcpServers": {
"nexusfeed-mcp": {
"command": "uvx",
"args": ["nexusfeed-mcp"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
## Cline（VS Code）配置
打开Cline设置 → MCP服务器 → 手动添加服务器：
**仅限LTL：**
```json
{
"nexusfeed-ltl": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
```
**仅限ABC：**
```json
{
"nexusfeed-abc": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
```
## 可流式HTTP（Smithery / 远程客户端）
| 服务器 | URL |
|--------|-----|
| LTL工具 | `https://api.nexusfeed.dev/mcp-ltl/` |
| ABC工具 | `https://api.nexusfeed.dev/mcp-abc/` |
在每个请求上传递您的`X-API-Key`标头。服务器元数据（无身份验证）：
```
https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json
https://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json
```
## 可验证性
每个工具响应都包含：
```json
"_verifiability": {
"source_timestamp": "2026-04-05T09:00:00Z",
"extraction_confidence": 0.97,
"raw_data_evidence_url": "https://odfl.com/...",
"extraction_method": "api_mirror",
"data_freshness_ttl_seconds": 604800
}
```
- `extraction_confidence >= 0.90` 在使用数据进行合规关键决策之前是必需的
- `source_timestamp` 在 `data_freshness_ttl_seconds` 内表示数据是从缓存中新鲜的
- `raw_data_evidence_url` 是规范源 - 代理可以独立验证
## 示例用法
**审计LTL货运发票：**
```
使用 freight_audit_workflow 提示，carrier="ODFL"，invoice_date="2026-04-01"，invoiced_fuel_surcharge_pct="23.5" 来检查计费费率是否与发布的资费匹配。
```
**在分销商交易前验证酒类许可：**
```
使用 abc_search_licenses，state="CA" 和 trade_name="Total Wine" 来检查当前的许可状态，然后使用 abc_lookup_license 获取具有暂停历史的完整记录。
```
## 故障排除
| 症状 | 修复 |
|---------|-----|
| 每个调用都返回401 | `MCP_API_KEY` 未设置或无效 |
| "无法访问API服务器" | `MCP_API_BASE_URL` 未设置 - 应该是 `https://api.nexusfeed.dev` |
| TX端点返回503 | TX TABC需要配置服务器端2Captcha；请改用CA、NY或FL |
| `extraction_confidence` < 0.90 | 数据质量下降 - 通过 `raw_data_evidence_url` 独立验证 |
## 许可证
**客户端代码（此仓库）：MIT。** 请参阅 [LICENSE](LICENSE)。
**NexusFeed后端服务（`https://api.nexusfeed.dev`）：商业。** 上述MIT许可证仅涵盖此存储库中的Python客户端包装器。它不授予数据服务的权利，数据服务需要付费API密钥并受单独的服务条款管辖。请联系 [ops@nexusfeed.dev](mailto:ops@nexusfeed.dev) 以获取企业SLA和许可。
