Metadata-Version: 2.4
Name: fapi-mcp
Version: 0.1.0
Summary: MCP server for the FAPI auto-parts catalog API (OEM cross-references, vehicle applicability, parts lookup)
Project-URL: Homepage, https://github.com/fapi-dev/fapi-mcp
Project-URL: Documentation, https://fapi-dev.github.io/catalog-openapi/
Project-URL: Repository, https://github.com/fapi-dev/fapi-mcp
Project-URL: Issues, https://github.com/fapi-dev/fapi-mcp/issues
Author-email: FAPI <development.iisis@gmail.com>
License: Apache-2.0
License-File: LICENSE
Keywords: auto-parts,automotive,cross-reference,fapi,mcp,model-context-protocol,oem
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# fapi-mcp

MCP server for the [FAPI Catalog API](https://fapi-dev.github.io/catalog-openapi/) — auto-parts OEM cross-references, vehicle applicability, and parts lookup, exposed as tools your AI assistant can call directly.

Drop it into Claude Desktop, Cursor, Cline, or any other MCP-compatible client, and ask things like:

> Find cross-references for MANN W 75/3 with at least 2 positive ratings.

> Which Toyota models use part AG+251 from MAHLE?

> What's the weight of part 10100 from manufacturer 13007?

---

## Install

Recommended (zero-install via [`uv`](https://docs.astral.sh/uv/)):

```bash
uvx fapi-mcp --help
```

Or with `pip`:

```bash
pip install fapi-mcp
```

## Configure in your MCP client

You need a FAPI API key. For evaluation, fetch the current public demo key:

```bash
curl -s https://gist.githubusercontent.com/serp83/652d191745773ef6d8b5a0a689479cd6/raw/demo-key.txt
```

Production access (your own key) — contact `development.iisis@gmail.com` or see [fapi.iisis.ru](https://fapi.iisis.ru).

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "fapi-catalog": {
      "command": "uvx",
      "args": ["fapi-mcp"],
      "env": {
        "FAPI_API_KEY": "<paste-your-key-here>"
      }
    }
  }
}
```

Restart Claude Desktop. The tools appear automatically.

### Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "fapi-catalog": {
      "command": "uvx",
      "args": ["fapi-mcp"],
      "env": { "FAPI_API_KEY": "<paste-your-key-here>" }
    }
  }
}
```

### Cline / Continue / other

Any MCP client that supports the stdio transport works. Point it at the `fapi-mcp` command with `FAPI_API_KEY` in the environment.

## Available tools

| Tool | What it does |
|---|---|
| `list_manufacturers` | Returns all known parts brands with their IDs. |
| `find_article_numbers` | Autocomplete article numbers by prefix. |
| `find_cross_references` | The main use case: find equivalent parts across brands by article number. Supports `min_confidence` filter. |
| `lookup_part` | Composite lookup — manufacturers + parts + crosses for a given article. |
| `get_part_attributes` | Weight, dimensions, and other attributes for a specific part. |
| `find_vehicles_for_part` | Which vehicles (makes, models, modifications) use this part. |
| `get_part_image_url` | Public URL for the product photo. |

## Development

```bash
git clone https://github.com/fapi-dev/fapi-mcp
cd fapi-mcp
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest
```

## License

Apache 2.0 — matches the [FAPI Catalog API spec](https://fapi-dev.github.io/catalog-openapi/).
