Thingiverse

🚀 萬物iverse MCP服務器

這是一個模型上下文協議（MCP）服務器，提供了與Thingiverse API交互的工具。藉助該服務器，AI助手能夠搜索、探索並檢索3D可打印模型。

  

🚀 快速開始

這個服務器使用Puppeteer和Stealth插件通過Thingiverse API進行交互，提供多種工具供AI助手調用。以下是項目的完整文檔，助你快速上手。

✨ 主要特性

• 搜索模型：可根據關鍵詞或分類ID搜索3D模型。
• 獲取隨機模型：能從Thingiverse中獲取隨機的3D模型。
• 獲取分類：可獲取所有可用的3D模型分類。
• 按分類獲取隨機模型：能從指定分類中獲取隨機的3D模型。

📦 安裝指南

先決條件

1. 安裝Node.js（推薦使用版本14及以上）。
2. 安裝npm包管理工具。
3. 創建並激活虛擬環境（可選但推薦）。

安裝步驟

1. 克隆項目倉庫：

   git clone https://github.com/your-repository.git
   cd thingiverse-mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 配置環境變量：

   • 創建.env.development文件並添加Thingiverse API令牌。
   • 創建.env.production文件並添加Thingiverse API令牌。

4. 運行開發服務器：

   npm run dev
   

5. 構建生產版本：

   npm run build
   

6. 啟動生產服務器：

   npm start
   

💻 使用示例

get-things工具

根據關鍵詞或分類ID搜索3D模型。

參數：

• term：搜索關鍵詞（必填）
• categoryId：可選的分類ID，用於縮小範圍

get-random-thing工具

獲取Thingiverse中的隨機3D模型。

get-categories工具

獲取所有可用的3D模型分類。

get-random-thing-from-category工具

從指定分類中獲取隨機的3D模型。

參數：

• categorySlug：分類標識符（必填）

🔧 技術細節

工作原理

服務器使用Puppeteer和Stealth插件通過Thingiverse API進行交互：

1. 處理身份驗證，使用API令牌。
2. 調用Thingiverse的不同端點。
3. 解析並返回結構化的數據。
4. 暴露MCP工具供AI助手調用。

項目結構

src/
├── class/
│   └── thingiverser.class.ts    # 主Puppeteer客戶端
├── endpoints/
│   ├── getCategories.ts         # 獲取所有分類
│   ├── getRandomThing.ts        # 獲取隨機模型
│   ├── getThings.ts             # 搜索模型
│   └── getThingsFromCategory.ts # 從分類中獲取模型
├── types/
│   ├── category.d.ts            # 分類類型定義
│   ├── files.d.ts               # 文件類型定義
│   └── things.d.ts              # 模型類型定義
└── index.ts                     # 入口點和MCP服務器設置

📚 詳細文檔

開發說明

環境配置

項目使用不同的環境文件：

• .env.development：開發模式下使用。
• .env.production：生產模式下使用。

測試

運行測試套件：

npm test

格式化和代碼檢查

# 運行ESLint
npm run lint

# 修復ESLint錯誤
npm run lint:fix

# 使用Prettier格式化
npm run format

部署說明

1. 確保.env.production文件包含有效的Thingiverse API令牌。
2. 構建過程會將此令牌嵌入到編譯代碼中。
3. 使用npm run prod構建並啟動生產服務器。

📄 許可證

本項目遵循MIT許可證 - 請查看 LICENSE 文件獲取詳細信息。