aras-plm-mcp
aras-plm-mcp
一个用于 Aras Innovator PLM 的 MCP 服务器,它了解 schema 而不是猜测它。
通过 OData 和 AML 提供 71 个工具。已针对一个真实的 Aras Innovator 2025 (14.35.0) 实例进行测试:十个测试套件共 260 条断言,外加一个 39 步的演示脚本端到端执行。71 个工具中的每一个都至少被一个套件使用,并且每个写入工具都执行了真实的写入。
问题
Aras Innovator 的 OData API 是动态的。服务文档返回 501 Not Implemented,而一个标准实例暴露了 484 个 ItemType,其名称和属性取决于管理员如何配置数据模型。没有静态目录可读。
一个简单的 HTTP 包装器 — get_items(itemtype, filter) — 将这个问题推给了模型。它必须猜测类型是 Part 而不是 Parts,物料清单是 Part BOM 而不是 BOM,数量字段是 quantity 而不是 qty。每次错误的猜测都是一次往返和一条不透明的错误。
这个服务器会检查 schema 并将其交还给你。
aras_describe_item_type itemType: "Part"
→ 41 typed properties, real mandatory flags, outgoing relationshipsRelated MCP server: PTC-MCP Integration Server
仅靠 OData 无法看到的内容
Aras 中有三件事对 OData 不可见,而每一件都是人们实际会问的问题。这个服务器通过 AML 来触及它们:
问题 | 为什么 OData 会失败 | 如何回答 |
"显示之前的修订版本。" | OData 只返回当前世代 — |
|
"发布这个零件。" | 生命周期转换不作为数据暴露 |
|
"推进这个变更单。" | — |
|
最后一项是通过服务器日志才找到的。Aras 返回 An internal error has occured;日志显示 Workflow: EvaluateActivity: Complete value not found。
工具
工具 | 作用 |
| 连接、数据库、用户、ItemType 数量 |
| 列出/搜索 ItemType,对拼写错误宽容 |
| 类型化属性、必填标志、传出关系 |
| 跨类型搜索,一次搜索多个 ItemType |
| 列表支持属性的允许值 |
| 尝试之前先咨询:从外部什么有效,以及错误意味着什么 |
aras_query_items, aras_get_item, aras_get_relationships, aras_get_bom,
aras_where_used, aras_get_documents, aras_get_aml, aras_get_files,
aras_read_file, aras_get_history, aras_get_revisions, aras_get_my_identities,
aras_get_identity_members, aras_export_aml
aras_get_bom(递归展开,带累计数量和逐分支循环检测),aras_manage_bom_line,aras_replace_component,aras_copy_part,
aras_add_manufacturer_part,aras_check_release_readiness,aras_check_effectivity
aras_create_change,aras_add_affected_item,aras_get_change_impact,
aras_get_workflow,aras_advance_change,aras_vote_activity,
aras_delegate_activity
生命周期映射和状态,以及每个转换所需的角色;用户、组、成员资格和权限;创建具有可用实例的 ItemType;
仪表板、指标、报告、已保存查询、序列、方法;来自 Serilog 文件和 SystemEventLog ItemType 的服务器日志。
先运行 aras_ping — 它会告诉你连接到了什么。
尝试之前先咨询
aras_how_to 回答 "如何从外部客户端做 X" 和 "为什么会出现这个错误",在模型开始猜测之前。
它故意不索引 Aras 的官方文档。该语料库描述的是客户端 JavaScript 和服务器端 C# — 正是从外部无法工作的路径 — 所以它会自信地指向死胡同。程序员指南中关于附加文件的答案是 aras.vault.selectFile,它只存在于 Aras 客户端内部。
它依赖于两个实际可靠的来源:
针对真实实例验证的知识,包含 Aras 返回的确切消息。
<Complete>1</Complete>,<ApplyItem>只应用批处理的第一个元素,依赖 ItemType 必须在关系内部创建 — 这些都不在任何手册中。实例本身 — 它的
UserMessage目录和已安装的Method。那是那个安装的真相,而不是通用的。
当它不知道时,它会说出来,而不是返回最接近的匹配。一个回答所有问题的工具和一个什么都不回答的工具一样无用。
值得了解的设计决策
默认只读。 对 PLM 的写入是版本化和审计的,所以它们是有意启用的:ARAS_READONLY=false。当它为 true 时,21 个写入工具中的每一个都会礼貌地拒绝。
dryRun 默认对批量操作开启。 aras_replace_component 和
aras_bulk_update 会显示受影响的行,在你要求之前不会更改任何内容。
写入会被读回。 aras_create_item,aras_update_item 和
aras_create_part 在写入后重新读取项目,并返回
proprietaNonApplicate 表示任何未生效的内容。Aras 接受并静默忽略某些属性 — Part 上的 cost 是由汇总计算的,所以设置它不会返回错误也没有效果。如果不读回,调用者会相信它写入了不存在的内容。
删除在执行之前会进行规划。 aras_plan_delete 报告哪些内容引用了该项目,并在有引用时拒绝。在无法验证关系的地方,它返回 -1 而不是假装关系为空 — 诚实的检查胜过免费让你安心的检查。
权限拒绝会被解码。 Aras 对拒绝的权限返回通用的 HTTP 500,而不是 403。aras_get_type_permissions 告诉你缺少哪个身份;aras_lookup_error 在 UserMessage 目录中查找消息。
项目引用只作为注解到达,并且只有使用 $select 时。 查询 Part BOM 带 $select 会得到 related_id@aras.id 和 related_id@aras.keyed_name;不带它,什么都不会返回,行看起来像不透明的元数据。这在 readItemRef()(src/aras/odata.ts)中编码了一次,所以调用者不必记住。这也是构建一个静默返回空树的 BOM 浏览器的最简单方法。
安装
npm install
npm run build将 .env.example 复制为 .env 并填写。对于 Claude Code,添加到 .mcp.json:
{
"mcpServers": {
"aras-plm": {
"command": "node",
"args": ["/path/to/aras-plm-mcp/dist/index.js"],
"env": {
"ARAS_URL": "http://localhost/InnovatorServer",
"ARAS_DATABASE": "InnovatorSolutions",
"ARAS_USER": "admin",
"ARAS_PASSWORD": "…",
"ARAS_CLIENT_ID": "IOMApp",
"ARAS_READONLY": "true"
}
}
}
}认证是针对 IOMApp 客户端的 OAuth 2.0 资源所有者密码凭据,范围 Innovator。
需要 Node 20+ 和一个允许你与之通信的 Aras Innovator 实例。
测试
每个套件都针对真实实例运行,只写入前缀为 ZZ- 的项目,并在之后删除它们。最后一个流程断言生产数据未被触碰。
node test-flussi.mjs # ten whole business flows, request to conclusion
node test-demo.mjs # the 39 blocks of the demo script, one by one
node test-full.mjs # connection, discovery, reading, navigation
node test-product.mjs # BOM, where-used, AML, documents, revisions
node test-lifecycle.mjs # lifecycle, transitions, roles
node test-schema.mjs # custom ItemTypes and properties
node test-admin.mjs # identities and permissions
node test-analytics.mjs # dashboards, metrics, effectivity
node test-reports.mjs # reports, saved queries, sequences, methods
node test-write.mjs # read-only refusals
node test-writepath.mjs # real writes, created and removedtest-flussi.mjs 是有趣的那个。它不测试工具 — 它测试问题,就像公司里的人会问的那样:
"一位设计师加入了:创建他们的账户并把他们放到正确的部门。" "编写一个新组件,通过审批,然后发布。" "在所有地方替换一个组件,但首先告诉我它会落在哪里。" "尝试删除一个在 BOM 中使用的组件:它必须拒绝。"
什么不起作用,以及为什么
有五件事从外部客户端无法到达。这不是疏忽,每个受影响的工具都会说明这一点,并指出替代方案,而不是不透明地失败。
证据 | |
上传文件到 vault | 六次不同的尝试,全部被拒绝: |
BOM 上的有效性表达式 |
|
执行 Query Builder 查询 | 没有 AML 操作可以从外部运行已保存的 |
基于 JavaScript 的报告 |
|
工作流地图上的节点坐标 |
|
另一方面,读取是有效的并且经过验证。aras_read_file 通过 OData 媒体资源(File('<id>')/$value)下载内容,回退到 vault 端点,并返回可读的内容:文本格式返回文本,包含文本的 PDF 返回提取的文本,PNG/JPEG/GIF/WebP 返回图像本身,以便实际查看。扫描的图纸会说明需要 OCR,而不是返回空字符串。
docs/field-notes.md 是现场日志:实时测试暴露的每个缺陷,以及证明每个限制的确切错误。
文档
从零开始,获得 Aras 的第一个回答 | |
它是如何组合在一起的,以及塑造这一切的陷阱 | |
十个完整的业务流程,以问题的形式呈现 | |
测试套件,以及如何在不造成任何影响的情况下运行它们 | |
实际测试暴露的问题:发现的缺陷,以及四件无法运作的事项 |
docs/it/ 存放原始意大利语材料:一份 39 块的演示脚本和原始测试日志。
贡献
非我们自己的实例是这里最需要的——不同版本、不同模板、不同数据模型。参见 CONTRIBUTING.md。
安全问题:请私下通过 SECURITY.md 报告。
许可证
MIT — 参见 LICENSE。
Available Tools
71 toolsaras_add_affected_itemB
Aggiunge un elemento fra quelli impattati da una ECR/ECN esistente.
Inputs: tipo (required), changeId (required), itemNumber (required), itemType.
aras_add_manufacturer_partB
Aggiunge un componente commerciale (Manufacturer Part) e lo approva su una Part, creando il costruttore se non esiste. Copre in un passo Manufacturer, Manufacturer Part e Part AML.
Inputs: mpn (required), perPart (required), costruttore (required), descrizione (required).
aras_add_propertyC
Aggiunge una proprieta' a un ItemType esistente.
Inputs: nome (required), tipo (required), itemType (required), etichetta, +2 more.
aras_advance_changeA
Fa avanzare una ECR/ECN votando l'attivita' ATTIVA del suo workflow. Fra le attivita' del processo una sola e' Active: le Pending sono a valle e votarle non produce effetti. dryRun mostra quale verrebbe votata.
Inputs: via (required), changeId (required), dryRun, commenti.
aras_aml_requestA
Via di fuga: esegue AML (Aras Markup Language) grezzo contro InnovatorServer.aspx. Da usare solo per cio' che OData non copre — logiche di query non esprimibili con $filter, metodi server, azioni speciali. Passa il frammento <Item .../>, l'envelope SOAP e' automatico. Le action che scrivono sono bloccate in sola lettura.
Inputs: itemXml (required).
aras_bulk_updateB
Aggiorna in blocco tutti gli elementi che corrispondono a un filtro OData. dryRun (default) elenca cosa verrebbe toccato senza scrivere.
Inputs: filtro (required), valori (required), itemType (required), dryRun, +1 more.
aras_check_effectivityA
Verifica se una Part era valida a una certa data, in base a effective_date e superseded_date. E' l'effettivita' basata sulle date, quella che Aras popola sempre. Per l'effettivita' configurabile per modello/unita' usa aras_get_effectivity_config.
Inputs: data (required), partIds (required).
aras_check_release_readinessA
Verifica se un assieme e' pronto per il rilascio: elenca i componenti della distinta non ancora rilasciati. Rilasciare un padre con figli in Preliminary e' l'errore piu' comune.
Inputs: partId (required), profondita.
aras_copy_partB
Duplica una Part con le sue proprieta' di dominio e, se richiesto, la distinta di primo livello. Revisione, stato e dati di audit vengono rigenerati da Aras.
Inputs: nuovo (required), origine (required), nuovoNome, conDistinta.
aras_create_changeA
Crea una ECR o una ECN con i suoi elementi impattati. Il numero (ECR-100001...) lo genera Aras e non va fornito. Gli Affected Item sono creati inline dentro la relazione: e' l'unico modo che funziona.
Inputs: tipo (required), title (required), impattati, description, +2 more.
aras_create_documentC
Crea un Document (disegno, specifica, manuale) o un CAD e lo collega a una Part.
Inputs: item_number (required), name, tipo, perPart, +3 more.
aras_create_effectivity_modelB
Crea un modello di prodotto, usabile come valore della variabile Model dell'effettivita' (es. 'CP-40', 'CP-60').
Inputs: nome (required), etichetta.
aras_create_groupC
Crea un gruppo o ruolo (Identity), opzionalmente annidato in un gruppo padre. I ruoli servono anche per le transizioni di ciclo di vita, che richiedono un'identita'.
Inputs: nome (required), descrizione, gruppoPadre.
aras_create_itemB
Crea un nuovo elemento. Le proprieta' vengono validate contro lo schema reale prima dell'invio. Disabilitato se il server e' in sola lettura (ARAS_READONLY).
Inputs: itemType (required), properties (required), dryRun.
aras_create_item_typeA
Crea un nuovo ItemType con le sue proprieta'. ATTENZIONE: Aras documenta questa configurazione solo dall'interfaccia (Administration -> ItemTypes), perche' oltre alla riga servono default permission, TOC Access e identita' Can Add. Il tool tenta l'intera sequenza e riporta passo per passo cosa e' riuscito, verificando alla fine se l'ItemType accetta davvero istanze.
Inputs: nome (required), etichetta, proprieta, versionabile, +2 more.
aras_create_partB
Crea una Part con validazione dello schema E dei valori di lista, opzionalmente agganciandola subito a un assieme padre in distinta.
Inputs: item_number (required), cost, name, unit, +7 more.
aras_create_relationshipA
Crea una riga di relazione fra due elementi (es. 'Part Document', 'Part BOM'). Supporta anche gli elementi DIPENDENTI, che in Aras non possono essere creati prima: passa dependentProperties invece di relatedId e l'elemento viene creato inline dentro la relazione. E' l'unico modo di collegare un Affected Item a una ECR/ECN. Disabilitato in sola lettura.
Inputs: sourceId (required), relationshipType (required), relatedId, properties, +1 more.
aras_create_userA
Crea un utente e lo iscrive ai gruppi indicati. In Aras servono tre passi: lo User, l'Identity alias che Aras genera da se', e le righe Member verso i gruppi. Creare un secondo Alias fallisce ('cannot be greater than 1'), quindi l'appartenenza passa da Member.
Inputs: nome (required), login (required), cognome (required), email, +2 more.
aras_delegate_activityA
Delega un'attivita' di workflow a un'altra identita', invece di votarla. Usa aras_get_workflow per trovare attivita' e assegnazione.
Inputs: aIdentita (required), activityId (required), assignmentId (required), dryRun, +1 more.
aras_delete_itemA
Cancella un elemento. RICHIEDE conferma esplicita e il modo desiderato. purge elimina solo la generazione indicata, delete elimina TUTTE le generazioni. Chiama prima aras_plan_delete. Disabilitato in sola lettura.
Inputs: id (required), modo (required), conferma (required), itemType (required), +1 more.
aras_describe_item_typeA
Restituisce lo schema completo di un ItemType: tutte le proprieta' con tipo di dato e obbligatorieta', piu' le relazioni che partono da esso. Da usare PRIMA di scrivere query o di creare elementi, cosi' non devi indovinare i nomi delle proprieta'.
Inputs: itemType (required).
aras_describe_queryA
Struttura di una query salvata: da quali ItemType parte e quali parametri accetta. Da chiamare prima di eseguirla.
Inputs: nome (required).
aras_export_amlB
Esporta elementi in AML, il formato nativo di scambio di Aras: utile per travasare configurazioni fra istanze o per conservare uno stato.
Inputs: itemType (required), filtro, massimo, conRelazioni.
aras_get_amlA
Costruttori approvati (Approved Manufacturer List) per una Part: i Manufacturer Part omologati e il relativo costruttore. Serve per acquisti e per valutare second source.
Inputs: partId (required).
aras_get_bomA
Esplode la distinta base (BOM) di una Part in modo ricorsivo, restituendo l'albero dei componenti con quantita' e quantita' cumulate. E' il modo corretto di rispondere a domande tipo 'da cosa e' composto questo prodotto' o 'quanti pezzi di X servono in totale'.
Inputs: partId (required), depth.
aras_get_change_impactA
Elementi realmente impattati da una modifica (ECR o ECN), risolvendo gli Affected Item. In Aras la relazione non punta alla Part ma a un oggetto intermedio, quindi una query diretta restituirebbe solo id opachi.
Inputs: changeId (required), changeType (required).
aras_get_documentsB
Tutta la documentazione di una Part: Document (disegni, specifiche, manuali) e modelli CAD in una sola chiamata. In Aras sono due relazioni distinte ma rispondono alla stessa domanda.
Inputs: partId (required).
aras_get_effectivity_configB
Configurazione dell'effettivita': scope, variabili (Model, Unit, Date), modelli di prodotto definiti e quante espressioni sono impostate sulle righe di distinta.
Inputs: no named parameters.
aras_get_filesA
File fisici allegati a un Document o a un CAD, con nome, dimensione, MIME type e URL di download dal vault. NOTA: il caricamento di file NON e' possibile da un client esterno — Aras rifiuta la creazione di File senza contenuto vaultato ('File Item cannot be added'), e le vie documentate sono solo JavaScript di client o C# di server. I file vanno caricati dall'interfaccia Aras. ATTENZIONE: questo tool restituisce METADATI e un URL di download, non il contenuto: il server non scarica ne' legge il file. Per il contenuto serve seguire l'URL con un client autenticato.
Inputs: id (required), itemType (required).
aras_get_historyA
Traccia di audit di un elemento: chi ha fatto cosa e quando, attraverso tutte le revisioni. Aras lega lo storico al config_id tramite un History Container, non all'id della singola generazione, quindi copre l'intera vita dell'oggetto.
Inputs: id (required), itemType (required), limite.
aras_get_identity_membersA
Membri di un'identita' Aras (reparto, gruppo, ruolo): utenti e sotto-gruppi. Usa aras_query_items su 'Identity' per trovare l'id del reparto.
Inputs: identityId (required).
aras_get_inbasketB
Attivita' in carico a un'identita' (utente o gruppo): l'equivalente dell'InBasket di Aras. Trova prima l'id dell'identita' con aras_query_items su 'Identity'.
Inputs: identityId (required), soloAperte.
aras_get_itemC
Recupera un singolo elemento tramite il suo id Aras (GUID a 32 caratteri).
Inputs: id (required), itemType (required), select.
aras_get_lifecycle_mapA
Grafo completo di un ciclo di vita: tutti gli stati e tutte le transizioni con il ruolo richiesto da ciascuna. Serve per capire quali percorsi esistono e chi puo' percorrerli.
Inputs: nomeMappa (required).
aras_get_lifecycle_stateA
Stato attuale di un elemento, stati verso cui l'utente corrente PUO' promuoverlo, e — se non puo' — quale ruolo gli manca. In Aras ogni transizione ha un ruolo richiesto: se non lo possiedi, getItemNextStates torna vuoto e promoteItem fallisce con un messaggio che sembra dire 'transizione inesistente' mentre e' un problema di autorizzazione.
Inputs: id (required), itemType (required).
aras_get_list_valuesA
Valori AMMESSI dalle proprieta' di tipo lista di un ItemType (es. make_buy, unit, drawing_size). Da chiamare PRIMA di creare: un valore fuori lista supera la validazione dello schema — il nome della proprieta' esiste — ma viene rifiutato o ignorato da Aras.
Inputs: itemType (required).
aras_get_logsA
Log di Aras da due sorgenti: i file del server su disco (Innovator, OAuth, Client) e l'ItemType SystemEventLog a database. Su un'installazione nuova possono essere entrambe vuote: il logging su file va abilitato nella configurazione del server.
Inputs: righe, filtro, includiDatabase.
aras_get_my_identitiesA
Identita' possedute dall'utente configurato, incluse quelle ereditate per appartenenza a gruppi. Serve a capire perche' una promozione o una scrittura viene rifiutata.
Inputs: no named parameters.
aras_get_permission_detailB
Diritti concessi da un Permission alle varie identita': chi puo' leggere, modificare, cancellare e scoprire gli elementi che lo usano.
Inputs: nomePermesso (required).
aras_get_relationshipsA
Restituisce le righe di una relazione a partire da un elemento sorgente, es. i documenti allegati a una Part ('Part Document') o le modifiche che la riguardano ('Part Changes'). Usa aras_describe_item_type per scoprire quali relazioni esistono.
Inputs: sourceId (required), relationshipType (required), top.
aras_get_revisionsA
Storia completa delle revisioni di un elemento versionabile: tutte le generazioni con revisione, stato, chi la tiene bloccata e quale e' la corrente. In Aras le generazioni sono righe distinte con id diversi che condividono config_id, e una query normale restituisce solo quella corrente: qui le vedi tutte.
Inputs: id (required), itemType (required).
aras_get_type_permissionsA
Quali identita' possono aggiungere, modificare o cancellare istanze di un ItemType, e se l'utente corrente ne fa parte. E' la risposta a 'perche' non riesco a creare questo': Aras restituisce i dinieghi di permesso come errore 500 generico, non come 403.
Inputs: itemType (required).
aras_get_workflowA
Processo di workflow di un elemento (ECR, ECN, Part...) con tutte le attivita', il loro stato e a chi sono assegnate. E' il modo di rispondere a 'a che punto e' questa modifica' e 'chi la sta bloccando'. Aras istanzia il processo automaticamente alla creazione.
Inputs: itemId (required), conAttivita.
aras_grant_permissionB
Concede o modifica i diritti di un'identita' su un Permission. Nota: senza 'scoprire' (can_discover) l'elemento non compare nemmeno nelle ricerche, quindi viene concesso automaticamente insieme alla lettura.
Inputs: identita (required), nomePermesso (required), leggere, scoprire, +2 more.
aras_how_toA
CONSULTA PRIMA DI TENTARE. Risponde a 'come si fa X su Aras da un client esterno' e 'perche' questo errore', attingendo a due fonti: il sapere verificato sul campo — cio' che funziona davvero da fuori, con il messaggio esatto che Aras restituisce — e l'istanza stessa, cioe' il catalogo UserMessage e i Method installati. NON usa la documentazione ufficiale Aras: quella descrive JavaScript di client e C# di server, cioe' proprio le vie che da un client esterno non funzionano, e seguirla porta con sicurezza su strade cieche. Chiamalo quando una chiamata fallisce in modo incomprensibile, o prima di tentare qualcosa di insolito.
Inputs: domanda (required), conIstanza.
aras_import_amlA
Applica un pacchetto AML: l'inverso di aras_export_aml. dryRun (default) analizza il contenuto e segnala quante azioni distruttive contiene prima di eseguirlo.
Inputs: contenuto (required), dryRun.
aras_list_dashboardsA
Cruscotti configurati in Aras, con i tipi di contenuto che ospitano. Su un'istanza standard ne esistono gia' diversi (Engineering Efficiency, Time To Manufacturing...).
Inputs: no named parameters.
aras_list_item_typesA
Elenca gli ItemType disponibili in Aras. L'istanza ne ha centinaia, quindi filtra con 'search' (ricerca tollerante su nome ed etichetta) oppure con 'kind'. Usalo PRIMA di interrogare dati, per scoprire il nome esatto del tipo.
Inputs: kind, limit, search.
aras_list_methodsA
Metodi server definiti in Aras, ricercabili per nome. Utili per capire quale logica personalizzata esiste, e invocabili con aras_aml_request.
Inputs: cerca, limite.
aras_list_metricsB
Metriche e indicatori definiti in Aras (es. 'ECR Cycle Time', 'Cost vs. Goal', 'CAD Model Release Time'). Filtra per nome se ne cerchi una in particolare.
Inputs: filtro.
aras_list_queriesA
Query salvate del Query Builder. Sono interrogazioni preconfezionate che Aras usa internamente e che puoi riusare, es. 'PE_BomStructure' o 'Aras.Resolution.LatestReleased'.
Inputs: no named parameters.
aras_list_reportsA
Report configurati in Aras, con gli ItemType a cui sono agganciati. Su un'istanza standard ce ne sono gia' diversi: BOM Costing Report, BOM Quantity Rollup Report, Approved Vendors Report.
Inputs: no named parameters.
aras_list_saved_searchesC
Ricerche salvate dagli utenti, con i criteri che usano.
Inputs: no named parameters.
aras_list_sequencesB
Sequenze di numerazione automatica configurate (ECR, ECN, Part...) con il prossimo valore che verrebbe assegnato.
Inputs: no named parameters.
aras_lookup_errorA
Cerca nel catalogo dei messaggi di Aras (UserMessage) per capire un errore opaco. Contiene i template di TUTTI i messaggi del server con i segnaposto {0}: cercando parte del testo ricevuto si risale al codice e al significato.
Inputs: testo (required), limite.
aras_manage_bom_lineB
Aggiunge, aggiorna o rimuove una riga di distinta base fra due Part, per item_number.
Inputs: azione (required), assieme (required), componente (required), quantita, +1 more.
aras_manage_membershipA
Aggiunge o rimuove un'identita' da un gruppo. E' il modo di concedere un ruolo — per esempio dare 'Aras PLM' a un utente perche' possa rilasciare le Part.
Inputs: azione (required), gruppo (required), membro (required).
aras_new_revisionA
Crea una nuova generazione (revisione) di un elemento versionabile, eseguendo la sequenza lock -> version -> unlock richiesta da Aras. Disabilitato in sola lettura.
Inputs: id (required), itemType (required).
aras_pingA
Verifica la connessione ad Aras Innovator e restituisce database, utente e numero di ItemType. Da usare per primo se qualcosa non funziona.
Inputs: no named parameters.
aras_plan_deleteA
ANALIZZA cosa comporterebbe cancellare un elemento, SENZA cancellarlo: quante generazioni sparirebbero, se e' rilasciato, se e' bloccato, e in quali relazioni e' ancora referenziato. Da chiamare SEMPRE prima di cancellare. Distingue purge (una generazione) da delete (tutte).
Inputs: id (required), itemType (required), modo, relazioni.
aras_promote_itemA
Promuove un elemento a un nuovo stato del ciclo di vita (es. Part da Preliminary a Released). Passa da AML perche' OData non espone le transizioni. Disabilitato in sola lettura.
Inputs: id (required), toState (required), itemType (required).
aras_query_itemsA
Interroga elementi di un ItemType con sintassi OData. Se non sei sicuro dei nomi delle proprieta', chiama prima aras_describe_item_type.
Inputs: itemType (required), top, skip, filter, +2 more.
aras_read_fileA
LEGGE IL CONTENUTO di un file del vault, non solo i metadati. Scarica dalla media resource OData (File('')/$value) con ripiego sull'endpoint del vault. Restituisce il testo per i formati testuali, il testo estratto per i PDF che ne contengono, e l'immagine stessa per PNG/JPEG/GIF/WebP, cosi' che possa essere guardata. Per un PDF scansionato dice che servirebbe un OCR invece di restituire il vuoto. Usa aras_get_files per trovare l'id.
Inputs: fileId (required), maxCaratteri.
aras_release_itemA
Rilascia un elemento portandolo allo stato target, percorrendo il grafo delle transizioni passo per passo. Con dryRun mostra il percorso e i ruoli richiesti senza eseguire nulla. NOTA: su un ItemType versionabile la promozione crea una nuova generazione, quindi l'id cambia.
Inputs: id (required), itemType (required), dryRun, statoTarget.
aras_replace_componentA
Sostituisce un componente con un altro in TUTTE le distinte che lo usano — obsolescenza, second source. dryRun (default) mostra prima quali assiemi verrebbero toccati.
Inputs: nuovo (required), vecchio (required), dryRun.
aras_run_queryA
Tenta di eseguire una query salvata del Query Builder. LIMITE NOTO: l'esecuzione non e' raggiungibile da un client esterno — nessuna action AML documentata la esegue. Il tool restituisce allora la STRUTTURA della query e indica con quali strumenti ottenere gli stessi dati (aras_query_items, aras_get_bom, aras_where_used).
Inputs: nome (required), maxRighe, parametri.
aras_run_reportA
Esegue un report e restituisce i DATI (la trasformazione XSL serve solo alla resa grafica nel client). Molti report sono parametrici: passa contestoId con l'id dell'elemento su cui eseguirlo.
Inputs: nome (required), massimo, contestoId.
aras_searchA
Ricerca trasversale su piu' ItemType contemporaneamente: cerca un termine nei campi testuali (codice, nome, descrizione, titolo) di Part, Document, CAD, ECR, ECN, fornitori. Da usare quando NON sai in che tipo si trovi cio' che cerchi — Aras non ha una ricerca globale.
Inputs: term (required), perType, itemTypes.
aras_update_itemA
Aggiorna le proprieta' di un elemento esistente. Validato contro lo schema. ATTENZIONE: su un ItemType versionabile (Part, Document, CAD) Aras crea una NUOVA GENERAZIONE a ogni update — anche solo per correggere una descrizione. Verificalo con aras_get_revisions prima e dopo se lo storico revisioni ti interessa. Disabilitato se il server e' in sola lettura.
Inputs: id (required), itemType (required), properties (required), dryRun.
aras_vote_activityA
Completa un'attivita' di workflow scegliendo una via di uscita (es. 'Approve', 'Reject'). Passa da AML EvaluateActivity. Usa aras_get_workflow per trovare attivita' e assegnazione. Disabilitato in sola lettura.
Inputs: path (required), activityId (required), assignmentId (required), commenti.
aras_where_usedA
Where-used: risale la distinta e trova TUTTI gli assiemi che usano un componente, a qualunque livello. E' la domanda da fare prima di modificare o dismettere un pezzo ('se cambio questa vite, cosa impatto?'). E' l'inverso di aras_get_bom.
Inputs: partId (required), depth.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 71 tools
Most tools are clearly scoped to a specific resource and action, and the descriptions are rich enough to separate queries, lifecycle, workflow, BOM, and admin operations. However, a few pairs are genuinely confusable—aras_promote_item vs aras_release_item and aras_create_item vs aras_create_part/aras_create_document—so it is not a perfect 5.
The aras_ prefix plus a verb_noun structure is used consistently across nearly all tools, with clear clusters like get_*, list_*, create_*, and manage_*. A handful of nonstandard names such as aras_how_to, aras_where_used, aras_bulk_update, and bare verbs like aras_search or aras_ping keep it from being fully consistent.
71 tools is far beyond the 50+ extreme threshold and dramatically more than the recommended agent-facing surface. Even for a broad PLM domain, this many entry points creates a heavy selection burden, and many niche administrative tools could be consolidated or exposed behind a smaller number of parameterized tools.
The surface is exceptionally comprehensive: item CRUD, revisions, lifecycle, workflow, BOM, change management, documents/files, permissions, admin, reporting, and AML are all covered. Minor gaps remain, such as no direct file upload path, no generic relationship delete/update tool, and aras_run_query being a known-limited fallback, but these are documented and usually workaroundable.
Maintenance
Related MCP Connectors
List datasets, schemas, run APL queries, and use prompts for exploration, anomalies, and monitoring.
Query Allen-Bradley and Siemens PLC projects, live tag values, and analyses in plain English.
Design and revise PCBs from plain language, track jobs, and retrieve design artifacts.
Query, explore, and manage your databases through natural conversation.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to interact with Aras Innovator PLM systems via OAuth 2.0, allowing users to query PLM data, create items, and call server methods through natural language.16MIT
- AlicenseBqualityDmaintenanceIntegrates PTC Windchill and Creo Parametric with LLM-based clients via the Model Context Protocol, enabling natural language interaction with PLM and CAD systems for tasks like part search, BOM retrieval, model operations, and exports.114MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with IBM Engineering Lifecycle Management (ELM), including DOORS Next Generation, EWM, and ETM, for managing requirements, work items, tests, and project builds through natural language.MIT
- AlicenseNot gradedqualityFmaintenanceIntegrates with Teamcenter PLM using its REST API, enabling search, create, update, and query of Teamcenter items through natural language.3ISC