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. AIアシスタントが呼び出せるMCPツールを公開します。

プロジェクト構造

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ファイルを参照してください。