Xem Studio
Exact-dimension geometry for AI agents: free STEP/STL files, dimension sheets, mating fit data.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"xemstudio": {
"command": "npx",
"args": [
"@xemstudio/mcp"
]
}
}
}可執行的套件
1.1.3stdio遠端端點
https://xemstudio.com/mcpstreamable-http它能做什麼
工具清單
工具（9）
🟢find_geometry(query, category, group, kind, year, ...)
Search the library of exact real-object geometry (fasteners, extrusion, sanitary fittings, electronics boards, phones and devices, motors, mounts, engine parts and complete assemblies) by name or keyword. Use it when you know what the thing is called; use find_by_dimensions when you only have measurements, list_categories to learn filter values. Every query word must appear in the object's name, aliases or tags (case-insensitive; '80-40', '80x40' and '8040' match alike); filters narrow with AND. Returns 20 summaries per page (limit up to 100) with total and next_offset for paging; an empty result means nothing matched every word, so retry with fewer words.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords, e.g. 'M3 heat set insert', 'tri clamp ferrule 2in', 'raspberry pi 5'. Omit to list by filters alone."
},
"category": {
"type": "string",
"description": "Exact category name from list_categories, e.g. 'Hardware'."
},
"group": {
"type": "string",
"description": "Exact group name within a category from list_categories, e.g. 'Fasteners'."
},
"kind": {
"type": "string",
"enum": [
"modern",
"vintage",
"standard",
"hardware",
"list"
],
"description": "modern/vintage = a product; standard = a part defined by a standard; hardware = a generated part with free files; list = a complete assembly with its parts list."
},
"year": {
"type": "string",
"description": "Release year for products: '2023', '2020s' or '2010-2019'; objects without a year are then excluded."
},
"free_only": {
"type": "boolean",
"description": "Only objects whose files are free to download."
},
"les_only": {
"type": "boolean",
"description": "Only parts used in Long Earth Society engine builds."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Page size, default 20."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Start index; pass next_offset from the previous page."
}
}
}輸出結構描述
{
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"count": {
"type": "integer"
},
"next_offset": {
"type": [
"integer",
"null"
]
},
"objects": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"group": {
"type": "string"
},
"kind": {
"type": "string"
},
"overall_mm": {
"type": "object"
},
"free_files": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": true
}
},
"next": {
"type": "string"
}
},
"required": [
"total",
"objects"
],
"additionalProperties": true
}🟢find_by_dimensions(sizes_mm, tolerance_mm, category)
Identify an object from sizes you measured (an outline, a bore, a pin, a flange) when you don't know its name; use find_geometry when you do. Each size is compared, within tolerance_mm, against the object's overall size in any order and against its exact feature sizes (bores, slots, pins, size tables). Ranked: all overall sizes matching first, then the most matching features; up to 25 results, each saying which numbers matched where. No match is not an error: widen tolerance_mm or file request_object.
輸入結構描述
{
"type": "object",
"properties": {
"sizes_mm": {
"type": "array",
"items": {
"type": "number"
},
"minItems": 1,
"maxItems": 4,
"description": "One to four sizes in mm, e.g. [40, 80] for a profile, [10.5] for a bore."
},
"tolerance_mm": {
"type": "number",
"minimum": 0,
"maximum": 5,
"description": "Allowed difference per size, default 0.5. Use about 0.2 for caliper readings of machined parts, 1 for rough measurements."
},
"category": {
"type": "string",
"description": "Optional exact category from list_categories to narrow the search."
}
},
"required": [
"sizes_mm"
]
}輸出結構描述
{
"type": "object",
"properties": {
"sizes_mm": {
"type": "array",
"items": {
"type": "number"
}
},
"tolerance_mm": {
"type": "number"
},
"total": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"overall_mm": {
"type": "object"
},
"all_overall_sizes_match": {
"type": "boolean"
},
"matching_features": {
"type": "array",
"items": {
"type": "object"
}
},
"size_table_rows_matched": {
"type": "integer"
},
"free_files": {
"type": "integer"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": true
}
},
"next": {
"type": "string"
}
},
"required": [
"total",
"results"
],
"additionalProperties": true
}🟢get_geometry(object)
Read the full dimension sheet of one object: overall size, mounting holes, notes, size tables, mating features, related objects (call get_geometry on their slugs to traverse), FAQ, and every public CAD source with its license. Use it to answer how big something is, where its holes are, or what it fits. It never returns download links: use get_free_files for those, get_assembly for a complete assembly, get_fits when you only need the mating features. Unknown objects return an error with a hint to search first.
輸入結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string",
"description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
}
},
"required": [
"object"
]
}輸出結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"sheet": {
"type": "object"
},
"sheet_text": {
"type": [
"string",
"null"
]
},
"mating": {
"type": "array",
"items": {
"type": "object"
}
},
"related": {
"type": "array",
"items": {}
},
"sources": {
"type": "array",
"items": {
"type": "object"
}
},
"faq": {
"type": "array",
"items": {
"type": "object"
}
},
"files": {
"type": "object",
"properties": {
"free_count": {
"type": "integer"
},
"how": {
"type": "string"
}
},
"required": [],
"additionalProperties": true
},
"paid_offers": {
"type": "array",
"items": {
"type": "object"
}
},
"dimensions": {
"type": "string"
}
},
"required": [
"slug",
"name",
"sheet"
],
"additionalProperties": true
}🟢get_free_files(object, filter)
List direct STEP and STL (and DXF where present) download URLs for one object's free files, licensed CC BY 4.0 (credit 'Xem Studio'). For a complete assembly (slug list-*) it returns the assembled model plus every part's files with quantities. Use it when you need files rather than dimensions (get_geometry) or file contents (get_file_content). An object with no free files returns an empty list and a note pointing to its public sources; that is not an error.
輸入結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string",
"description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
},
"filter": {
"type": "string",
"description": "Keep only files whose name or note contains this text, e.g. 'm3x10' or '2in'."
}
},
"required": [
"object"
]
}輸出結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string"
},
"license": {
"type": "string"
},
"count": {
"type": "integer"
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"step": {
"type": "string"
},
"stl": {
"type": [
"string",
"null"
]
}
},
"required": [],
"additionalProperties": true
}
},
"assembly": {
"type": [
"object",
"null"
]
},
"parts": {
"type": "array",
"items": {
"type": "object"
}
},
"note": {
"type": "string"
}
},
"required": [
"object"
],
"additionalProperties": true
}🟢get_file_content(object, file, format)
Return the contents of one free file so you can read or modify the geometry directly: STEP and DXF as UTF-8 text, STL as base64; units are millimetres. Use it after get_free_files gives you the file name; use get_free_files instead when a download URL is enough. Files over 600 KB are not inlined: you get size_bytes and the URL. An unknown file name returns an error listing the valid names.
輸入結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string",
"description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
},
"file": {
"type": "string",
"description": "A file name exactly as get_free_files lists it, e.g. '4080-100'."
},
"format": {
"type": "string",
"enum": [
"step",
"dxf",
"stl"
],
"description": "Default step. DXF exists only for 2D sections such as extrusion profiles."
}
},
"required": [
"object",
"file"
]
}輸出結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string"
},
"file": {
"type": "string"
},
"format": {
"type": "string"
},
"size_bytes": {
"type": "integer"
},
"encoding": {
"type": "string"
},
"url": {
"type": "string"
},
"inlined": {
"type": "boolean"
},
"content": {
"type": "string"
},
"units": {
"type": "string"
},
"license": {
"type": "string"
}
},
"required": [
"object",
"file",
"format",
"url"
],
"additionalProperties": true
}🟢get_assembly(object)
Return everything needed to build one complete assembly from its parts list (slug list-*, e.g. an engine or an alternator module): what it is and its performance numbers, every part line with quantity, placement note and file URLs, each part's mating features, the build order, and the assembled STEP/STL in which every part is already in position. Use it instead of calling get_geometry part by part; find assemblies with find_geometry(kind='list'). A slug that is not a list returns an error.
輸入結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string",
"description": "An assembly slug starting 'list-', e.g. 'list-ta-ring-3x2in'."
}
},
"required": [
"object"
]
}輸出結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string"
},
"name": {
"type": "string"
},
"what": {
"type": "string"
},
"numbers": {
"type": "string"
},
"assembly": {
"type": [
"object",
"null"
]
},
"part_lines": {
"type": "integer"
},
"parts_total": {
"type": "integer"
},
"lines": {
"type": "array",
"items": {
"type": "object"
}
},
"build_order": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"object",
"name",
"lines"
],
"additionalProperties": true
}🟢get_fits(object)
Return only the mating features of one object: each hole, pin, pocket, slot or socket that meets another part, its exact size, what it mates with, and its fit class (press, slide, run, socket, clamp, designed). Use it before preparing a part to print or machine, or when get_geometry's full sheet is more than you need. All sizes are exact with no clearance: add your process allowance to press, slide, run and socket features only; designed and clamp features stay as drawn. Objects without mating features return an empty list.
輸入結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string",
"description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
}
},
"required": [
"object"
]
}輸出結構描述
{
"type": "object",
"properties": {
"object": {
"type": "string"
},
"dimensions": {
"type": "string"
},
"mating": {
"type": "array",
"items": {
"type": "object",
"properties": {
"feature": {
"type": "string"
},
"exact": {
"type": "string"
},
"mates": {
"type": "string"
},
"fit": {
"type": "string"
}
},
"required": [],
"additionalProperties": true
}
},
"fit_classes": {
"type": "object"
},
"note": {
"type": "string"
}
},
"required": [
"object",
"mating"
],
"additionalProperties": true
}🟢list_categories
List every category and the groups inside it with object counts, plus the catalog version. Use it to get the exact category and group names that find_geometry and find_by_dimensions filter on; it takes no input and returns the whole tree in one call.
輸入結構描述
{
"type": "object",
"properties": {}
}輸出結構描述
{
"type": "object",
"properties": {
"version": {
"type": "string"
},
"total": {
"type": "integer"
},
"categories": {
"type": "object",
"description": "category name -> { count, groups: { group name -> count } }"
}
},
"required": [
"total",
"categories"
],
"additionalProperties": true
}🟡request_object(text, contact)
File a request for an object the library lacks so it gets added. Use it only after find_geometry and find_by_dimensions find nothing suitable. Each call stores one new request (calling twice files two) in the owner's private inbox; nothing else changes and nothing is published. Stored: the text, the optional contact and the time, with no IP address. Requests set the order objects are added; there is no reply unless a contact is given. At most 300 requests a day are accepted site-wide.
輸入結構描述
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Plain description: exact model or part number if known, what it must fit or mate with, which features matter, and any sizes already known. 3 to 4000 characters."
},
"contact": {
"type": "string",
"description": "Optional email or handle for a reply; include only if the person asks to be contacted."
}
},
"required": [
"text"
]
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"id": {
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"ok"
],
"additionalProperties": true
}社群
證據