Skip to content

README.md

Latest commit

 

History

History
103 lines (73 loc) · 2.7 KB

README.md

File metadata and controls

103 lines (73 loc) · 2.7 KB
Raw

fapi-mcp

MCP server for the FAPI Catalog API — 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):

uvx fapi-mcp --help

Or with pip:

pip install fapi-mcp

Configure in your MCP client

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

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.

Claude Desktop

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

{
  "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:

{
  "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

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.