Mercado Livre - MCP Server

Mercado Livre から価格や在庫状況などの商品データを直接スクレイピングする MCP ツールを利用できるようにする統合機能です。

目次

• 機能
• アーキテクチャ
• インストール
• VSCode での MCP サーバーの設定
• VSCode での MCP サーバーの出力
• 貢献
• ライセンス

機能

• get-produtos：商品の基本情報を取得します。
• Zod を使用した入力検証。
• fetch（インフラストラクチャレイヤー）を使用した Mercado Livre API との統合。

アーキテクチャ

このプロジェクトでは、ドメイン駆動設計（DDD）のパターンに着想を得たレイヤーアーキテクチャを採用しています。

• ドメイン（src/domain）： データ構造（例：Mercado Livre）を表すインターフェースと型を定義します。

• インフラストラクチャ（src/infrastructure）： Mercado Livre API への HTTP 呼び出しを担当する MercadoLivreApiService など、外部サービスを実装します。

• アプリケーション（src/application）： インフラストラクチャからのデータを処理、整形する MercadoLivreService にビジネスロジックを含みます。

• インターフェース（src/interface）： MCP サーバーにツールを登録し、検証スキーマを定義して結果を返すコントローラー（MercadoLivreToolsController）を含みます。

• エントリーポイント（src/main.ts）： McpServer を初期化し、トランスポート（StdioServerTransport）を設定して、サービスとコントローラーをインスタンス化し、stdio での待ち受けを開始します。

フォルダー構造は次のとおりです。

src/
├── domain/
│   └── models/           # Domain interfaces
├── infrastructure/
│   └── services/         # External API implementations (Mercado Livre)
├── application/
│   └── services/         # Business logic and data formatting
├── interface/
│   └── controllers/      # MCP tool registration and validation
└── main.ts               # Server entry point
build/                    # Compiled JavaScript code
.vscode/                  # Contains the mcp.json file, MCP Server config

インストール

git clone [email protected]:newerton/mcp-mercado-livre.git
cd mcp-mercado-livre
npm install
npm run build

VSCode での MCP サーバーの設定

1. Ctrl+Shift+P を押して、「MCP: List Servers」を選択します。
2. 「products」を選択し、「Start Server」を選択します。

VSCode での MCP サーバーの出力

1. Ctrl+Shift+P を押して、「MCP: List Servers」を選択します。
2. 「products」を選択し、「Show Output」を選択します。

貢献

プルリクエストを歓迎します。お気軽に課題を報告し、改善について話し合ってください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。