catalog
Search real parts with datasheet-provenance specs, check compatibility and compose priced BOMs.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen fetch
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"catalog": {
"url": "https://partsgraph.ai/api/mcp"
}
}
}Puntos de conexión remotos
https://partsgraph.ai/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (11)
🟢search_parts(query, category, build, role, limit, ...)
Full-text search over the demo catalogue's provenance-backed part records. Filter by category, build or role. Every attribute returned was corroborated against the manufacturer datasheet or vendor page.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What you are looking for"
},
"category": {
"type": "string"
},
"build": {
"type": "string"
},
"role": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25
},
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"matched": {
"type": "number"
},
"rankedForProject": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"parts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"manufacturer": {
"type": "string"
},
"mpn": {
"type": "string"
},
"category": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"manufacturer",
"mpn",
"category",
"url"
],
"additionalProperties": {}
}
}
},
"required": [
"query",
"matched",
"rankedForProject",
"parts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_part(id, project_context)
The complete canonical record for one part: every attribute with its provenance (source, page, verbatim quote, file hash), vendors with dated indicative prices, and datasheet links.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Part id, e.g. pololu-drv8833-carrier"
},
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_categories(project_context)
Every category in the catalogue with its part count.
Esquema de entrada
{
"type": "object",
"properties": {
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"parts": {
"type": "number"
}
},
"required": [
"id",
"label",
"parts"
],
"additionalProperties": false
}
}
},
"required": [
"categories"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_builds(project_context)
The catalogue's reference builds (robot, weather station, plant waterer) with their roles and candidate parts — the starting point for build_bom.
Esquema de entrada
{
"type": "object",
"properties": {
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"builds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": {}
}
}
},
"required": [
"builds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢check_compatibility(part_ids, build_id, project_context)
Evaluates a part set against the build's engineering constraints — supply windows, stall vs peak current, shaft/wheel fit, interfaces, solar chain — with a reasoned verdict per check. Every number cited is a corroborated attribute.
Esquema de entrada
{
"type": "object",
"properties": {
"part_ids": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"build_id": {
"description": "Defaults to the build these parts overlap most",
"type": "string"
},
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"required": [
"part_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"build": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verdicts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"constraint": {
"type": "string"
},
"kind": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pass",
"fail",
"warn",
"info"
]
},
"detail": {
"type": "string"
},
"parts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"constraint",
"kind",
"status",
"detail",
"parts"
],
"additionalProperties": false
}
},
"unknown": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
}
},
"required": [
"build",
"verdicts",
"unknown",
"summary"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢compare_parts(a, b, project_context)
Aligned attribute-by-attribute comparison of two catalogue parts. Absence means the sources did not state a value — never that the part lacks the property.
Esquema de entrada
{
"type": "object",
"properties": {
"a": {
"type": "string",
"description": "First part id"
},
"b": {
"type": "string",
"description": "Second part id"
},
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"required": [
"a",
"b"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"a": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"b": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"same": {
"type": "boolean"
}
},
"required": [
"code",
"label",
"a",
"b",
"same"
],
"additionalProperties": false
}
},
"summary": {
"type": "string"
}
},
"required": [
"rows",
"summary"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_provenance(id, code, project_context)
The receipt behind a stated value: the verbatim source quote, the page, the extraction method, and the sha-256 of the exact file it was read from — plus a ready-made citation line. Omit code for every attribute's receipt.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Part id"
},
"code": {
"description": "Attribute code from get_part; omit for all",
"type": "string"
},
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"part": {
"type": "string"
}
},
"required": [
"part"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢build_bom(build_id, choices, project_context)
Composes a complete BOM for a reference build — quantities, dated indicative prices, per-line rationale, a compatibility verdict for the chosen set, and a CSV export. Override any role with choices.
Esquema de entrada
{
"type": "object",
"properties": {
"build_id": {
"type": "string",
"description": "2wd-robot, weather-station or plant-waterer"
},
"choices": {
"description": "role → part id overrides",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"project_context": {
"description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
"type": "string",
"maxLength": 500
}
},
"required": [
"build_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"build": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": {}
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"qty": {
"type": "number"
}
},
"required": [
"role",
"qty"
],
"additionalProperties": {}
}
},
"compatibility": {
"type": "array",
"items": {
"type": "object",
"properties": {
"constraint": {
"type": "string"
},
"kind": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pass",
"fail",
"warn",
"info"
]
},
"detail": {
"type": "string"
},
"parts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"constraint",
"kind",
"status",
"detail",
"parts"
],
"additionalProperties": false
}
},
"csv": {
"type": "string"
}
},
"required": [
"build",
"lines",
"compatibility",
"csv"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢search(query)
Search the Partsgraph demo catalogue. Returns result ids for fetch. Alias of search_parts shaped to the search/fetch connector contract.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string"
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢fetch(id)
Fetch the full provenance-backed record for a search result id as a citable document. Alias of get_part shaped to the search/fetch connector contract.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"text",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢view_bom(build_id, choices)
Composes the BOM for a reference build and renders it as an interactive view in clients that support MCP Apps. Same data as build_bom.
Esquema de entrada
{
"type": "object",
"properties": {
"build_id": {
"type": "string",
"description": "2wd-robot, weather-station or plant-waterer"
},
"choices": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"build_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"build": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": {}
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"qty": {
"type": "number"
}
},
"required": [
"role",
"qty"
],
"additionalProperties": {}
}
}
},
"required": [
"build",
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}Comunidad
Evidencia