README.md
3D printing filament and materials knowledge MCP server.
3dprint-oracle
3D printing filament and materials knowledge MCP server. Gives LLMs authoritative access to 7,000+ filaments and curated material science knowledge.
Features
- 7,000+ filaments from SpoolmanDB (53 manufacturers, 33 material types)
- Material science knowledge — properties, troubleshooting, recommendations
- 8 MCP tools — search, lookup, compare, recommend, diagnose
- Embedded data — no API keys, no network calls at runtime
Installation
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"3dprint-oracle": {
"command": "npx",
"args": ["-y", "3dprint-oracle"]
}
}
}
Tools
| Tool | Description |
|---|---|
search_filaments |
Search filaments by name, material, manufacturer, color |
get_filament |
Get full specs for a specific filament |
list_manufacturers |
Browse manufacturers with filament counts |
list_materials |
Browse material types with counts |
get_material_profile |
Authoritative properties for a material type |
compare_materials |
Side-by-side comparison of 2-3 materials |
recommend_material |
Get ranked recommendations for your requirements |
diagnose_print_issue |
Troubleshoot print problems with material-specific fixes |
Data Sources
- Filament data: SpoolmanDB (MIT license)
- Material knowledge: Hand-curated from authoritative 3D printing references
License
MIT
Tools (8)
search_filamentsSearch filaments by name, material, manufacturer, colorget_filamentGet full specs for a specific filamentlist_manufacturersBrowse manufacturers with filament countslist_materialsBrowse material types with countsget_material_profileAuthoritative properties for a material typecompare_materialsSide-by-side comparison of 2-3 materialsrecommend_materialGet ranked recommendations for your requirementsdiagnose_print_issueTroubleshoot print problems with material-specific fixesConfiguration
claude_desktop_config.json
{"mcpServers": {"3dprint-oracle": {"command": "npx", "args": ["-y", "3dprint-oracle"]}}}Try it
→Find me a list of PLA filaments from Prusament.
→Compare the material properties of PETG and ABS.
→I am having issues with warping on my nylon prints, can you diagnose this?
→Recommend a flexible material suitable for outdoor use.
→What are the key differences between PLA and PETG for functional parts?