encarapi-mcp 1.7.0 → 1.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/package.json +2 -2
- package/src/server.js +27 -3
package/README.md
CHANGED
|
@@ -19,8 +19,9 @@
|
|
|
19
19
|
| `find_korean_car_by_vin` | All Encar / K Car listings of one VIN, incl. removed ones (Business/Scale key) |
|
|
20
20
|
| `get_korean_truck` | Full record for one truck: detail, inspection report, cargo box, VIN and plate (Business/Scale key) |
|
|
21
21
|
| `get_korean_car` | Full detail for one listing (specs, options, photos, price history, seller, `diagnosisReport` on Encar listings; `lang`: en, ru or de) |
|
|
22
|
-
| `get_korean_inspection` | Official Korean inspection report |
|
|
22
|
+
| `get_korean_inspection` | Official Korean inspection report; Encar ids and `kbc:` ids (KB Chachacha sheet in the same format, where `InspectionAvailable` is true) |
|
|
23
23
|
| `get_korean_diagnosis` | Encar diagnosis (엔카진단): which outer panels were replaced, inspector verdict incl. frame result (Encar listings only) |
|
|
24
|
+
| `get_korean_history` | Encar vehicle history (차량이력): inspections, repairs, owner changes, insurance claims, recalls, odometer over time (Encar listings only) |
|
|
24
25
|
| `get_korean_accident_record` | Insurance accident history and ownership changes |
|
|
25
26
|
| `find_korean_models` | Model name autocomplete across brands |
|
|
26
27
|
| `korean_filter_values` | Valid filter values |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "encarapi-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.8.1",
|
|
4
4
|
"description": "MCP server for EnCarAPI and ChinaCarAPI: live Korean (Encar, KB Chachacha, K Car) and Chinese (Dongchedi, Che168) used car listings for Claude, Cursor and other AI assistants.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "src/server.js",
|
|
@@ -49,7 +49,7 @@
|
|
|
49
49
|
},
|
|
50
50
|
"dependencies": {
|
|
51
51
|
"@modelcontextprotocol/sdk": "^1.32.0",
|
|
52
|
-
"encarapi": "^1.
|
|
52
|
+
"encarapi": "^1.9.1",
|
|
53
53
|
"express": "^5.2.1",
|
|
54
54
|
"zod": "^4.1.0"
|
|
55
55
|
}
|
package/src/server.js
CHANGED
|
@@ -4,7 +4,7 @@ import encarapi from "encarapi";
|
|
|
4
4
|
|
|
5
5
|
const { KoreaClient, ChinaClient } = encarapi;
|
|
6
6
|
|
|
7
|
-
export const VERSION = "1.
|
|
7
|
+
export const VERSION = "1.8.1";
|
|
8
8
|
const MAX_TEXT = 40000;
|
|
9
9
|
|
|
10
10
|
const asText = (data) => {
|
|
@@ -324,8 +324,13 @@ export function createServer({ apiKey, chinaKey, fetchImpl, transport = "stdio",
|
|
|
324
324
|
"get_korean_inspection",
|
|
325
325
|
{
|
|
326
326
|
title: "Get a Korean inspection report",
|
|
327
|
-
description:
|
|
328
|
-
|
|
327
|
+
description:
|
|
328
|
+
"Official Korean inspection report (performance check) for one car: panels, frame, mechanical condition. " +
|
|
329
|
+
"Ids: an Encar id, or kbc:<id> for a KB Chachacha listing whose sheet we read (InspectionAvailable true in " +
|
|
330
|
+
"get_korean_car, about two in five KB Chachacha listings that link a sheet) - same format as Encar's plus a " +
|
|
331
|
+
"source block. Other kbc: ids return 404: detailPending true = sheet not read yet (retry later), " +
|
|
332
|
+
"inspectionAvailable false = no structured sheet (original link in inspectionReportUrl). K Car ids are not supported.",
|
|
333
|
+
inputSchema: { id: z.string().describe("Encar id, or kbc:<id> for a KB Chachacha listing") },
|
|
329
334
|
annotations: readOnly,
|
|
330
335
|
},
|
|
331
336
|
run(({ id }) => needKorea().inspection(id))
|
|
@@ -349,6 +354,25 @@ export function createServer({ apiKey, chinaKey, fetchImpl, transport = "stdio",
|
|
|
349
354
|
run(({ id }) => needKorea().diagnosis(id))
|
|
350
355
|
);
|
|
351
356
|
|
|
357
|
+
server.registerTool(
|
|
358
|
+
"get_korean_history",
|
|
359
|
+
{
|
|
360
|
+
title: "Get an Encar vehicle history",
|
|
361
|
+
description:
|
|
362
|
+
"Encar's vehicle history (차량이력) for one Encar listing: the timeline of inspections, repairs, owner " +
|
|
363
|
+
"changes, insurance claims and recalls, with every dated odometer reading (mileageReadings, oldest " +
|
|
364
|
+
"first - a reading lower than an earlier one is worth a closer look), ownership periods, summary flags " +
|
|
365
|
+
"and a Korean one-line summary (summaryKo). Encar collects it from the Ministry of Land, Infrastructure " +
|
|
366
|
+
"and Transport and the Korea Insurance Development Institute; about 8 in 10 Encar listings have one. " +
|
|
367
|
+
"Keys and enums are English, Korean source text stays in the *Ko fields. A 404 with historyAvailable " +
|
|
368
|
+
"false means Encar shows no public history for the listing, historyPending true means not collected " +
|
|
369
|
+
"yet. Encar ids only (no kbc:/kcar:). Separate from get_korean_inspection and get_korean_accident_record.",
|
|
370
|
+
inputSchema: { id: z.string().describe("Encar listing id from search_korean_cars") },
|
|
371
|
+
annotations: readOnly,
|
|
372
|
+
},
|
|
373
|
+
run(({ id }) => needKorea().history(id))
|
|
374
|
+
);
|
|
375
|
+
|
|
352
376
|
server.registerTool(
|
|
353
377
|
"get_korean_accident_record",
|
|
354
378
|
{
|