mcp-lcsc

Model Context Protocol server for LCSC OpenAPI component lookup.

mcp-lcsc lets an MCP client search LCSC by keyword or C-number and fetch product details for JLCPCB assembly workflows. It does not ship credentials; live lookups require your own LCSC API key and secret.

Note

This is an alpha extraction from the SpectraSynq K1 hardware automation stack. The server is intentionally narrow: LCSC search and item lookup only.

Quickstart

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[dev]"
pytest

Set credentials before live MCP use:

export LCSC_API_KEY="..."
export LCSC_API_SECRET="..."
mcp-lcsc

MCP client config

After installing the package in the Python environment used by your MCP client, add:

{
  "mcpServers": {
    "lcsc": {
      "command": "mcp-lcsc",
      "args": [],
      "env": {
        "LCSC_API_KEY": "YOUR_LCSC_API_KEY",
        "LCSC_API_SECRET": "YOUR_LCSC_API_SECRET"
      }
    }
  }
}

See examples/claude_desktop_config.json.

Tools

• search(keyword, is_available=True, page_size=30) — search LCSC products by keyword or C-number.
• item(product_number) — fetch details for one LCSC product number.

Credential handling

• Do not commit .env files or real MCP client configs containing credentials.
• LCSC_API_KEY and LCSC_API_SECRET are read from environment variables.
• The server fails before making a network request if live lookup credentials are missing.
• Tests use deterministic signature inputs and do not call LCSC.

Provenance

Extracted from SpectraSynq/K1.hardware commit 54d2eed3687a27503404b862b631a65615097e2a; see docs/provenance.md.

This repo is now the canonical home for the LCSC MCP server.

License

Apache-2.0 — see LICENSE.