Etsy MCP Server

Etsy MCP Server

Node.js と TypeScript で構築された、Etsy API 統合用の Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Web インターフェースを使用せずに、Claude Desktop から Etsy の出品をプログラムで管理するための標準化された方法を利用できます。

特長

• Etsy API による OAuth 2.0 認証
• 下書きの出品を作成
• 出品に画像をアップロード
• タクソノミー情報（カテゴリー）を取得
• Model Context Protocol を通じて Claude Desktop と連携

前提条件

• Node.js 16+
• Yarn パッケージマネージャー
• API キーを持つ Etsy Developer アカウント
• Etsy ショップ
• Claude Desktop

セットアップ

1. リポジトリをクローンします

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

2. 依存関係をインストールします

yarn install

3. .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

4. プロジェクトをビルドします

yarn build

5. サーバーを起動します

yarn start

サーバーは http://localhost:3000 で利用できます。

6. Etsy で認証します

ブラウザーで http://localhost:3000 にアクセスし、認証リンクをクリックします。認証に成功すると、トークンが保存されます。

7. Etsy ショップ ID を確認します

yarn find:shop-id

表示されたショップ ID で .env ファイルを更新します。

Claude Desktop への接続

1. MCP サーバーが実行中であることを確認します（yarn start）
2. Claude Desktop を開きます
3. 「Settings」>「MCP Servers」>「Add New Server」をクリックします
4. 次の情報を入力します：
   • 名前：Etsy MCP Server
   • URL：http://localhost:3000/mcp
5. 「Add Server」をクリックします
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

ライセンス

MIT