Etsy MCP Server

Name: Etsy MCP Server
Author: vienle90

远程服务

github.com/vienle90商业与营销073 周前更新

代码仓库

关于 Etsy MCP Server

Etsy MCP Server 是一个基于 Node.js 和 TypeScript 的 Etsy API 接入服务，面向需要通过 Claude Desktop 管理店铺商品的用户。它提供 OAuth 2.0 认证，并支持创建草稿商品、上传图片和查询分类。

主要功能

01通过 OAuth 2.0 认证
02创建商品草稿
03上传商品图片
04获取商品分类信息

适用场景

01通过 Claude Desktop 创建 Etsy 商品草稿
02为商品刊登上传图片
03查询可用的 Etsy 商品分类

MCP 相关

它通过 MCP 向 Claude Desktop 暴露 Etsy 工具，客户端可调用工具并通过 Etsy API 执行操作。

#etsy #mcp-server #api-integration

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址http://localhost:3000/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http etsy-mcp-server-vienle90 http://localhost:3000/mcp

Cursor.cursor/mcp.json{"mcpServers":{"etsy-mcp-server-vienle90":{"type":"http","url":"http://localhost:3000/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"etsy-mcp-server-vienle90":{"type":"http","url":"http://localhost:3000/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"etsy-mcp-server-vienle90":{"type":"http","url":"http://localhost:3000/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"etsy-mcp-server-vienle90":{"serverUrl":"http://localhost:3000/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Etsy MCP 服务

一个用于集成 Etsy API 的模型上下文协议（MCP）服务，使用 Node.js 和 TypeScript 构建。此服务为 Claude Desktop 提供了一种标准化方式，可通过编程管理 Etsy 商品，而无需使用网页界面。

功能

使用 Etsy API 进行 OAuth 2.0 身份验证
创建草稿商品
为商品上传图片
获取分类信息（类别）
通过模型上下文协议与 Claude Desktop 兼容

先决条件

Node.js 16+
Yarn 包管理器
拥有 API 密钥的 Etsy 开发者账号
Etsy 商店
Claude Desktop

设置

克隆代码库

git clone https://github.com/yourusername/etsy-mcp-server.git
cd etsy-mcp-server

安装依赖项

yarn install

根据 .env.example 创建 .env 文件，并填写 Etsy API 凭据

# Etsy API credentials
ETSY_API_KEY=your_api_key_here  # This is also your Client ID
ETSY_CLIENT_SECRET=your_client_secret_here
ETSY_SHOP_ID=your_shop_id_here

# OAuth settings
ETSY_REDIRECT_URI=http://localhost:3000/callback
ETSY_SCOPES=listings_r listings_w shops_r

# Server configuration
PORT=3000

构建项目

yarn build

启动服务

yarn start

服务将在 http://localhost:3000 上运行。

使用 Etsy 进行身份验证

在浏览器中访问 http://localhost:3000，然后点击身份验证链接。身份验证成功后，令牌将被保存。

查找 Etsy 商店 ID

yarn find:shop-id

使用显示的商店 ID 更新 .env 文件。

连接到 Claude Desktop

确保 MCP 服务正在运行（yarn start）
打开 Claude Desktop
点击“Settings” > “MCP Servers” > “Add New Server”
输入以下信息：
- 名称：Etsy MCP Server
- URL：http://localhost:3000/mcp
点击“Add Server”
Claude 将自动发现可用工具

在 Claude Desktop 中使用 MCP 服务

连接后，你可以让 Claude 执行如下操作：

“为手工制作的陶瓷马克杯创建新的 Etsy 商品”
“为我的 Etsy 商品上传图片”
“显示可用的 Etsy 类别”

Claude 将通过 Etsy API 使用 MCP 服务执行这些操作。

可用的 MCP 工具

createDraftListing - 在 Etsy 上创建草稿商品
uploadListingImage - 为商品上传图片
getTaxonomies - 获取所有商品分类体系

开发

构建项目：

yarn build

在开发模式下运行并自动重新加载：

yarn dev

项目结构

etsy-mcp-server/
├── src/
│   ├── api/         # Etsy API client
│   ├── auth/        # OAuth authentication
│   ├── config/      # Configuration
│   ├── models/      # TypeScript interfaces
│   ├── tools/       # MCP tools implementation
│   ├── config.ts    # Configuration loader
│   ├── index.ts     # Main entry point
│   └── mcp-server.ts # MCP server implementation
├── .env.example     # Example environment variables
├── package.json     # Project dependencies
└── tsconfig.json    # TypeScript configuration