io.github.jinweihan-ai/ferrolaser-parts
Fiber laser parts knowledge: laser sources, cutting/welding heads, CNC controls, alarm codes.
Open source Repository Open in the app JSON README (API)
About
Fiber laser parts knowledge: laser sources, cutting/welding heads, CNC controls, alarm codes.
Details
- Kind
- MCP servers
- Topic
- IoT & hardware
- Publisher
- jinweihan-ai
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 1
- Last push
- 2026-07-03T08:36:56Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 04:00:15
- Updated
- 2026-08-29 04:00:15
- Origin id
io.github.jinweihan-ai/ferrolaser-parts
README
# FerroLaser Parts Knowledge MCP Server
**Fiber laser machine parts & components knowledge base as an MCP server** — 521 structured
knowledge cards covering **fiber laser sources (Raycus, Max Photonics, JPT), laser cutting
heads and welding heads (Raytools / Empower, OSPRI, Super Laser), CNC control systems
(BOCHU / Friendess FSCUT, CypCut / HypCut)**: key specifications, wiring diagrams, alarm /
error code explanations, consumable part numbers, and selection advice — all distilled from
official manufacturer manuals.
Maintained by [FerroLaser](https://www.ferrolaser.com) — an industrial fiber laser machine
manufacturer in Jinan, China (laser cutting machines, welding machines, cleaning machines,
marking machines, sold factory-direct worldwide).
## What can an AI assistant do with this?
- *"What does Raycus alarm code XX mean and how do I fix it?"*
- *"BLT421 vs BM111 cutting head — which fits a 6kW source?"*
- *"FSCUT2000 wiring: which terminal takes the servo alarm input?"*
- *"What consumable part numbers does the Raytools BW06K welding head use?"*
- *"How is a fiber laser cutting machine put together?"* (component anatomy overview)
- Send a sourcing / quote inquiry straight to FerroLaser's engineers (`submit_inquiry`)
## Endpoint (hosted, free)
```
https://mcp.ferrolaser.com/mcp
```
Transport: **Streamable HTTP** (stateless). No authentication required for knowledge tools.
### Claude Desktop / Claude Code
```bash
claude mcp add --transport http ferrolaser-parts https://mcp.ferrolaser.com/mcp
```
or in `claude_desktop_config.json` / `.mcp.json`:
```json
{
"mcpServers": {
"ferrolaser-parts": {
"type": "http",
"url": "https://mcp.ferrolaser.com/mcp"
}
}
}
```
### Cursor / other MCP clients
Add a remote MCP server with URL `https://mcp.ferrolaser.com/mcp` (Streamable HTTP).
## Tools
| Tool | What it does |
|---|---|
| `search_parts_knowledge(query, brand?, top?)` | Weighted search over 521 cards (title/brand/positioning/body), with brand-alias expansion (Friendess→BOCHU, Raytools→Empower, 锐科→Raycus…) |
| `get_part_card(card_id \| title)` | Full card: spec tables, wiring, alarm codes, consumable part numbers, field notes |
| `list_brands()` | Brands covered, card counts, one-line intro each |
| `get_brand_overview(topic)` | Category essays: `anatomy`, `laser-sources`, `cutting-heads`, `welding-heads`, `control-systems`, `cladding-cleaning` |
| `submit_inquiry(name, email, message, …)` | Reach FerroLaser sales engineers (machine quotes / part sourcing); human reply within one business day |
Card bodies are written in Chinese (distilled from bilingual official manuals) — AI clients
translate on the fly; model numbers, part numbers and alarm codes are language-neutral.
## Self-hosting
```bash
docker compose up -d --build # serves on :8890, path /mcp
```
Set `GATEWAY_TOKEN` env only if you wire `submit_inquiry` to your own backend; knowledge
tools work without any configuration.
## Data & license
- Knowledge cards are distilled from **publicly available official manufacturer manuals**;
no pricing, no BOMs, no customer data. Source PDFs are downloadable at
[ferrolaser.com/resources](https://www.ferrolaser.com/resources/).
- Code: MIT. Knowledge data (`app/parts_kb.json`, `app/overviews/`): CC BY 4.0 —
attribution "FerroLaser (ferrolaser.com)".
---
*Fiber laser cutting machine · laser welding machine · laser cleaning machine · laser
marking machine — [FerroLaser](https://www.ferrolaser.com), Jinan, China.*