使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，旨在为AI助手提供访问 Thingiverse 3D 模型资源的能力。它封装了 Thingiverse API，使得 AI 助手可以通过标准化的 MCP 协议，轻松搜索、浏览和获取 Thingiverse 上的 3D 打印模型信息。

主要功能点

模型搜索: 通过关键词在 Thingiverse 上搜索 3D 模型。
分类浏览: 浏览 Thingiverse 提供的模型分类。
随机模型: 发现 Thingiverse 上的随机 3D 模型。
模型详情: 获取模型的详细信息，包括描述、文件、图片等。
AI 助手集成: 通过 MCP 协议与 AI 助手（如 Claude Desktop）无缝集成。

安装步骤

克隆仓库

git clone https://github.com/gpaul-faldin/MCP_thingiverse
cd MCP_thingiverse

安装依赖
```
npm install
```
配置环境变量
- 复制 '.env.example' 文件并创建 '.env.development' 和 '.env.production' 文件：
```
cp .env.example .env.development
cp .env.example .env.production
```
- 前往 Thingiverse Developer Portal 获取 Thingiverse API Token，并将其填入 '.env.development' 和 '.env.production' 文件中的 'APP_TOKEN' 变量。

服务器配置

MCP 客户端（如 Claude Desktop）需要以下 JSON 配置信息来连接到 Thingiverse MCP 服务器。请根据您的实际情况配置 'command' 和 'args' 字段。

{
  "serverName": "thingiverse",
  "command": "node",
  "args": [
    "YOUR_PATH/MCP_thingiverse/dist/index.js"
  ]
}

配置参数说明:

'serverName': 服务器名称，可以自定义，例如 "thingiverse"。
'command': 运行服务器的命令，通常为 'node'。
'args': 启动服务器的参数，指向编译后的 'index.js' 文件路径。 请将 'YOUR_PATH/MCP_thingiverse' 替换为您的 MCP_thingiverse 仓库的实际路径。 如果您在项目根目录下运行 Claude Desktop，并且已经执行了 'npm run build'，则可以简化为 '["dist/index.js"]'。

基本使用方法

启动服务器
- 开发模式: 'npm run dev' (支持热重载)
- 生产模式: 'npm run prod' (先执行 'npm run build')
配置 MCP 客户端
- 将上述 服务器配置 添加到您的 MCP 客户端中（例如 Claude Desktop 的自定义 MCP 设置）。确保 URL 或文件路径配置正确，指向正在运行的 Thingiverse MCP 服务器。
与 AI 助手交互
- 在 AI 助手（如 Claude）中，您可以提问关于 Thingiverse 3D 模型的问题，例如：
- "在 Thingiverse 上找一些 3D 打印的手机支架"
- "展示一些小工具分类下的热门 3D 模型"
- "给我推荐一个 Thingiverse 上的随机 3D 模型"
- "Thingiverse 上有哪些 3D 模型分类？"
AI 助手将利用 Thingiverse MCP 服务器提供的工具来响应您的请求。

关键词