AI导哈

Etsy API集成服务器

一个基于Node.js和TypeScript构建的Etsy API集成服务器，通过Model Context Protocol为Claude Desktop提供程序化管理Etsy列表的功能。

  • by vienle90
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 vienle90/etsy-mcp-server

使用说明

Etsy MCP服务器

用于Etsy API集成的模型上下文协议（MCP）服务器，使用Node.js和TypeScript构建。此服务器为Claude Desktop提供了一种标准化的方式，可以在不使用web界面的情况下以编程方式管理Etsy列表。

特性

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

先决条件

  • Node.js 16+
  • 纱线包装经理
  • 带有API密钥的Etsy开发人员帐户
  • Etsy商店
  • 克劳德桌面

设置

  1. 克隆存储库
git clone https://github.com/yourusername/etsy-mcp-server.git
cd etsy-mcp-server
  1. 安装依赖项
yarn install
  1. 创建一个 .env 文件基于 .env.example 并填写您的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
  1. 构建项目
yarn build
  1. 启动服务器
yarn start

服务器将在以下时间可用 http://localhost:3000.

  1. 通过Etsy进行身份验证

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

  1. 查找您的Etsy商店ID
yarn find:shop-id

更新您的 .env 显示店铺ID的文件。

连接到克劳德桌面

  1. 确保MCP服务器正在运行(yarn start)
  2. 打开克劳德桌面
  3. 点击“设置”>“MCP服务器”>“添加新服务器”
  4. 输入以下信息：
    • 名称：Etsy MCP服务器
    • 网址：http://localhost:3000/mcp
  5. 点击“添加服务器”
  6. Claude将自动发现可用的工具

在Claude Desktop中使用MCP服务器

连接后，您可以要求Claude执行以下操作：

  • “为手工陶瓷杯创建一个新的Etsy列表”
  • “将图片上传到我的Etsy列表”
  • “显示可用的Etsy类别”

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

可用的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

许可证

麻省理工学院

相关 MCP