{"_id":"@car2db/mcp-server","_rev":"2-4bd776fba24d7ba44eafb0a482541a2d","name":"@car2db/mcp-server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@car2db/mcp-server","version":"1.0.0","keywords":["mcp","car2db","vehicle","automotive","api","model-context-protocol"],"author":{"name":"Car2DB"},"license":"MIT","_id":"@car2db/mcp-server@1.0.0","maintainers":[{"name":"car2db.com","email":"support@car2db.com"}],"homepage":"https://github.com/car2db/car2db-api-v3-mcp#readme","bugs":{"url":"https://github.com/car2db/car2db-api-v3-mcp/issues"},"bin":{"car2db-mcp":"dist/index.js"},"dist":{"shasum":"e68690634b5d51a6317c6c888fb33d8b5cee6efd","tarball":"https://registry.npmjs.org/@car2db/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":78,"integrity":"sha512-blQ4y96eUv23cE86fC2eOg5fWDhccctyHNtizCyoVjCoCFdATM28Q1M93xIpBVrdxKzvwN/UOUNQHIOJkMA1tw==","signatures":[{"sig":"MEYCIQCMDAg9sNdmcomseWr4EjnbMxr6rPjPOPyjKq5Vn1lKzAIhAMJSs4R6CZBUuzfBsp1Ew8DlAkP5JB+zRPbUsvGmPx7s","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":130929},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"2305cacd57a81496b316e3f9af6428ea28072707","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"car2db.com","email":"support@car2db.com"},"repository":{"url":"git+https://github.com/car2db/car2db-api-v3-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for Car2DB API v3, allowing LLM agents to work with the automotive database","directories":{},"_nodeVersion":"24.1.0","dependencies":{"express":"^4.21.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.3","@types/node":"^22.10.5","@types/express":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1770493168480_0.6546356208644324","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@car2db/mcp-server","version":"1.0.2","description":"MCP server for Car2DB API v3, allowing LLM agents to work with the automotive database","main":"dist/index.js","type":"module","bin":{"car2db-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","typecheck":"tsc --noEmit"},"keywords":["mcp","car2db","vehicle","automotive","api","model-context-protocol"],"author":{"name":"Car2DB"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/car2db/car2db-api-v3-mcp.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","express":"^4.21.2"},"devDependencies":{"@types/express":"^5.0.0","@types/node":"^22.10.5","tsx":"^4.19.2","typescript":"^5.7.3"},"engines":{"node":">=20.0.0"},"publishConfig":{"access":"public"},"_id":"@car2db/mcp-server@1.0.2","gitHead":"f7db40e9f0cc7f33f7087ffded7b22f3b7e0c3be","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/car2db/car2db-api-v3-mcp/issues"},"homepage":"https://github.com/car2db/car2db-api-v3-mcp#readme","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-KBK8PDeAP/KauuQ3NSSuw0zcamVIvxNoYYYYxXStQyMZ+DZZjIUJ7j/J5rBbmeI1o6bWJvg3TDvJzcE+L92xjQ==","shasum":"68be34237d40b225f04930784cd1210c4d88fb63","tarball":"https://registry.npmjs.org/@car2db/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":83,"unpackedSize":17092921,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHYJcziVAJV/S5or3YBFuxfnLeCpWjQfVehuPM45F6/fAiA5yECVrzbmxrc9z0eVmgWz6Tzs0a601GMLNmX33eQZ8Q=="}]},"_npmUser":{"name":"car2db.com","email":"support@car2db.com"},"directories":{},"maintainers":[{"name":"car2db.com","email":"support@car2db.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.2_1771842924061_0.26325199642165686"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-07T19:39:28.336Z","modified":"2026-02-23T10:35:24.790Z","1.0.0":"2026-02-07T19:39:28.613Z","1.0.2":"2026-02-23T10:35:24.669Z"},"bugs":{"url":"https://github.com/car2db/car2db-api-v3-mcp/issues"},"author":{"name":"Car2DB"},"license":"MIT","homepage":"https://github.com/car2db/car2db-api-v3-mcp#readme","keywords":["mcp","car2db","vehicle","automotive","api","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/car2db/car2db-api-v3-mcp.git"},"description":"MCP server for Car2DB API v3, allowing LLM agents to work with the automotive database","maintainers":[{"name":"car2db.com","email":"support@car2db.com"}],"readme":"# Car2DB MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@car2db/mcp-server)](https://www.npmjs.com/package/@car2db/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP (Model Context Protocol) server for Car2DB API v3, enabling LLM agents (Claude, ChatGPT, Cursor, VSCode) to directly interact with automotive database.\n\n## Features\n\n- **Complete Vehicle Database** — Access detailed specifications for cars, motorcycles, and trucks\n- **Smart Search** — Natural language vehicle search\n- **Rich Data** — Technical specs, equipment packages, and detailed characteristics\n- **Multi-language** — Support for 11 languages\n- **Dual Transport** — stdio (Claude Desktop/Cursor) and SSE (remote access)\n- **Docker Ready** — Production-ready containerization\n\n## Quick Start\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"car2db\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@car2db/mcp-server\"],\n      \"env\": {\n        \"CAR2DB_API_KEY\": \"your_api_key_here\",\n        \"CAR2DB_REFERER\": \"https://yourproject.com\",\n        \"CAR2DB_LANGUAGE\": \"en-US\"\n      }\n    }\n  }\n}\n```\n\n**Get your API key:** https://car2db.com/api/\n**Try demo key:** https://car2db.com/api-token-demo/\n\n### GitHub Copilot Configuration\n\nFor GitHub Copilot, use the `.vscode/mcp.json` configuration file in your project:\n\n```json\n{\n  \"servers\": {\n    \"car2db\": {\n      \"command\": \"node\",\n      \"args\": [\"dist/index.js\"],\n      \"env\": {\n        \"CAR2DB_API_KEY\": \"your_api_key_here\",\n        \"CAR2DB_REFERER\": \"https://yourproject.com\",\n        \"CAR2DB_LANGUAGE\": \"en-US\",\n        \"MCP_TRANSPORT\": \"stdio\"\n      }\n    }\n  }\n}\n```\n\nOr use npx for zero-install:\n\n```json\n{\n  \"mcpServers\": {\n    \"car2db\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@car2db/mcp-server\"],\n      \"env\": {\n        \"CAR2DB_API_KEY\": \"your_api_key_here\",\n        \"CAR2DB_REFERER\": \"https://yourproject.com\",\n        \"CAR2DB_LANGUAGE\": \"en-US\"\n      }\n    }\n  }\n}\n```\n\n**Get your API key:** https://car2db.com/api/  \n**Try demo key:** https://car2db.com/api-token-demo/\n\n## Installation Options\n\n### 1. MCPB Package (One-Click Install)\n\nDownload the pre-built MCPB extension for easy installation in Claude Desktop or other MCP clients:\n\n**[Download car2db-api-v3-mcp.mcpb](https://github.com/car2db/car2db-api-v3-mcp/releases/latest/download/car2db-api-v3-mcp.mcpb)**\n\nMCPB is a ZIP archive containing a local MCP server and `manifest.json` describing the server and its capabilities — just download and install with one click.\n\n#### Installation Steps:\n1. Download the `.mcpb` file from GitHub releases\n2. Double-click the file or drag it into your MCP client\n3. Configure your API key in the setup dialog (optional, demo key will be used if not provided)\n4. Click \"Install\" and start using the extension\n\n**GitHub Releases:** https://github.com/car2db/car2db-api-v3-mcp/releases\n\n### 2. npx (Zero Install)\n\n```bash\nnpx @car2db/mcp-server\n```\n\n### 3. Global npm Installation\n\n```bash\nnpm install -g @car2db/mcp-server\ncar2db-mcp\n```\n\n### 4. Local Development\n\n```bash\ngit clone https://github.com/car2db/car2db-api-v3-mcp.git\ncd car2db-api-v3-mcp\nnpm install\nnpm run build\nnpm start\n```\n\n### 5. Docker (for SSE mode)\n\n```bash\ndocker-compose up -d\n```\n\nOr manually:\n\n```bash\ndocker build -t car2db-mcp .\ndocker run -p 3000:3000 \\\n  -e CAR2DB_API_KEY=your_key \\\n  -e CAR2DB_REFERER=https://yourproject.com \\\n  car2db-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CAR2DB_API_KEY` | ✅ | — | Bearer token for API authorization. Get it at [car2db.com/api](https://car2db.com/api/) |\n| `CAR2DB_REFERER` | ✅ | — | URL of your project/site (e.g. `https://yourproject.com`). Must match the URL registered with your API key. |\n| `CAR2DB_LANGUAGE` | ❌ | `en-US` | API response language: `en-US`, `ru-RU`, `de-DE`, `es-ES`, `it-IT`, `pl-PL`, `fr-FR`, `da-DA`, `lv-LV`, `th-TH`, `zh-CN` |\n| `MCP_TRANSPORT` | ❌ | `stdio` | Transport mode: `stdio` (Claude Desktop/Cursor) or `sse` (HTTP Server-Sent Events) |\n| `MCP_SSE_PORT` | ❌ | `3000` | Port for SSE mode (only used when `MCP_TRANSPORT=sse`) |\n\n### Referer header\n\nThe Car2DB API requires a `Referer` header in every request. Set `CAR2DB_REFERER` to the URL of the project or site that uses this MCP server. This URL must match the one registered with your API key on [car2db.com](https://car2db.com/api/).\n\nIf `CAR2DB_REFERER` is not set, a warning is printed at startup and API requests will fail with `403 Forbidden`.\n\n### Example .env file\n\n```bash\nCAR2DB_API_KEY=your_api_key_here\nCAR2DB_REFERER=https://yourproject.com\nCAR2DB_LANGUAGE=en-US\nMCP_TRANSPORT=stdio\n```\n\n## Available Tools\n\n### Smart Tools (High-Level)\n\n| Tool | Description | Key Parameters |\n|------|-------------|----------------|\n| `search_vehicles` | Natural language vehicle search | `q` (search text), `typeId`, `yearFrom`, `yearTo` |\n| `get_trim_full` | Complete trim specifications | `trimId` |\n| `get_equipment_full` | Full equipment/package details | `equipmentId` |\n| `browse_catalog` | Navigate catalog hierarchy | `level` (makes/models/generations/series/trims/equipments), parent IDs |\n\n### Low-Level Tools (Direct API Access)\n\n| Tool | Description | Key Parameters |\n|------|-------------|----------------|\n| `list_makes` | List all vehicle manufacturers | `page`, `itemsPerPage`, `typeId` |\n| `list_models` | List models by make | `makeId`, `typeId`, pagination |\n| `list_generations` | List model generations | `modelId`, `typeId`, pagination |\n| `list_series` | List series (body styles) | `modelId`, `generationId`, `typeId`, pagination |\n| `list_trims` | List trims (engine variants) | `seriesId`, `modelId`, `typeId`, pagination |\n| `get_year_vehicles` | Vehicles by production year | `year`, `typeId` |\n\n### Tool Parameters Reference\n\n- **`typeId`**: Vehicle type filter\n  - `1` = Cars\n  - `2` = Motorcycles\n  - `3` = Trucks\n\n- **`page`**: Page number (default: 1)\n- **`itemsPerPage`**: Items per page (default: 30)\n\n## Usage Examples\n\n### Example 1: Find specific vehicle specifications\n\n```\nClaude: \"What are the specifications of 2020 BMW X5 xDrive40i?\"\n\nAgent workflow:\n1. search_vehicles(q: \"BMW X5 xDrive40i 2020\")\n2. get_trim_full(trimId: <from_search_results>)\n3. Returns: breadcrumbs, key specs, full specifications, available equipments\n```\n\n### Example 2: Compare equipment packages\n\n```\nClaude: \"Compare equipment packages for Toyota Camry 2023\"\n\nAgent workflow:\n1. search_vehicles(q: \"Toyota Camry 2023\")\n2. get_trim_full(trimId: ...) → get equipment list\n3. get_equipment_full(equipmentId: A) → package A options\n4. get_equipment_full(equipmentId: B) → package B options\n5. Compare and present differences\n```\n\n### Example 3: Browse catalog\n\n```\nClaude: \"Show me all Tesla models\"\n\nAgent workflow:\n1. browse_catalog(level: \"makes\") → find Tesla\n2. browse_catalog(level: \"models\", makeId: 56) → all Tesla models\n3. browse_catalog(level: \"trims\", modelId: 789) → trims for Model 3\n```\n\n### Example 4: Year-based search\n\n```\nClaude: \"What electric SUVs were available in 2024?\"\n\nAgent workflow:\n1. get_year_vehicles(year: 2024, typeId: 1)\n2. Filter for electric powertrains\n3. Filter for SUV body types\n4. Present results\n```\n\n## SSE Mode (Remote Access)\n\nFor remote access or integration with web services, use SSE transport:\n\n### Start SSE Server\n\n```bash\nexport MCP_TRANSPORT=sse\nexport MCP_SSE_PORT=3000\nnpm start\n```\n\nOr with Docker:\n\n```bash\ndocker-compose up -d\n```\n\n### SSE Endpoints\n\n- **SSE Connection:** `GET http://localhost:3000/sse`\n- **Messages:** `POST http://localhost:3000/messages`\n- **Health Check:** `GET http://localhost:3000/health`\n\n## API Coverage\n\nThis MCP server provides access to Car2DB API v3 endpoints:\n\n- `/search/vehicles` — Vehicle search\n- `/makes` — Manufacturers list\n- `/models` — Vehicle models\n- `/generations` — Model generations\n- `/series` — Body style series\n- `/trims` — Engine/transmission trims\n- `/trims/{id}/full` — Complete trim data\n- `/equipments/{id}/full` — Equipment packages\n- `/years/{year}` — Vehicles by year\n\n**Base URL:** `https://v3.api.car2db.com`\n\n## Development\n\n### Build\n\n```bash\nnpm run build\n```\n\n### Type Check\n\n```bash\nnpm run typecheck\n```\n\n### Development Mode\n\n```bash\nnpm run dev\n```\n\n## Get API Access\n\n- **Purchase API Key:** https://car2db.com/api/\n- **Try Demo Key:** https://car2db.com/api-token-demo/\n- **API Documentation:** https://v3.api.car2db.com/docs\n\n## Requirements\n\n- Node.js >= 20.0.0\n- Valid Car2DB API key\n\n## License\n\nMIT License\n\n## Links\n\n- **Repository:** https://github.com/car2db/car2db-api-v3-mcp\n- **npm Package:** https://www.npmjs.com/package/@car2db/mcp-server\n- **Car2DB API:** https://car2db.com/api/\n- **Model Context Protocol:** https://modelcontextprotocol.io/\n\n## Support\n\nFor API-related questions and support:\n- Email: support@car2db.com\n- Website: https://car2db.com\n- Telegram: https://t.me/car2db_support_bot\n\nFor MCP server issues:\n- GitHub Issues: https://github.com/car2db/car2db-api-v3-mcp/issues\n","readmeFilename":"README.md"}