内容
<img src="./assets/logo-400.png" alt="Clara Carros" width="96" align="right" />
# Clara Carros MCP 服务器
[](https://modelcontextprotocol.io) [](./LICENSE)
Clara Carros MCP 服务器允许 AI 助手与 **[Clara Carros](https://claracars.pt)** 合作，提供葡萄牙二手车的实时库存搜索、估算进口税（**ISV**）、估算车辆转售价值，并提供联系方式。
本服务器是基于 `claracars.pt` 公共 API 的开源封装，无需密钥，设置简单。
> **一键安装：** 参考 [`llms-install.md`](./llms-install.md) — 可读性强的设置指南。
## 工具列表
| 工具 | 功能 |
|------|--------------|
| `search_inventory` | 按品牌、型号、燃料类型、价格、年份搜索当前库存 |
| `get_car` | 获取某辆车的详细信息和规格 |
| `calculate_isv` | 估算葡萄牙汽车进口税（ISV） |
| `calculate_iuc` | 估算葡萄牙年度道路税（IUC） |
| `list_makes_models` | 其他工具期望的规范品牌/型号名称 |
| `estimate_resale_value` | 葡萄牙某辆车的市场价值范围 |
| `list_services` | Clara Carros 提供服务 |
| `contact_me` | 请求人类协助（需要用户同意和联系信息） |
| `request_import_quote` | 请求 Clara Carros 寻找并报价进口车辆 |
## 使用方法
### 远程（添加 URL）
```
https://claracars.pt/mcp
```
在支持远程/流式 HTTP MCP 服务器的客户端中添加。
### 本地（stdio，通过 npx）
Claude Desktop / Cline / Continue 配置：
```json
{
"mcpServers": {
"claracars": {
"command": "npx",
"args": ["-y", "claracars-mcp"]
}
}
}
```
## 示例
- "在 Clara Carros 库存中查找价格低于 €20,000 的柴油旅行车。"
- "2016 年柴油车，1950 cc，130 g/km CO₂ 的 ISV 和年度 IUC 道路税是多少？"
- "我的 2018 年款 VW Golf，行驶 100,000 公里，在葡萄牙的价值是多少？"
- "请求 Clara Carros 寻找 2021 年款 BMW 320d Touring，我的名字是 …，电话 …"
## 配置
| 环境变量 | 默认值 | 目的 |
|---------|---------|---------|
| `CLARACARS_API_BASE` | `https://claracars.pt/api/public` | 公共 API 基地址 |
| `CLARACARS_LANG` | `en` | 响应语言（pt/en/ru/ua） |
| `PORT` / `MCP_PATH` | `8099` / `/mcp` | HTTP 服务器（远程模式） |
## 开发
```bash
npm install
npm run build
node dist/index.js # stdio
npm run start:http # 远程 HTTP，端口 :8099/mcp
```
## 注意事项
- **估算值，非报价。** ISV 和转售价值为估算值；官方 ISV 由葡萄牙税务机关评估。
- **隐私。** `contact_me` / `request_import_quote` 发送用户提供的信息到 Clara Carros ([隐私政策](https://claracars.pt/en/privacy))；有速率限制，需要用户明确意图。
- 本仓库不包含任何业务逻辑或数据，仅调用公共 API。
MIT © Clara Carros
