MCP agent for MedusaJS
概览
A comprehensive that provides automated API tools for . This server exposes all major Medusa admin API functionality through MCP-compatible tools for use with AI assistants like Claude Desktop. Medusa.js is a modern, open-source e-commerce platform built for developers. It provides a headless commerce backend with powerful admin APIs for managing products, orders, customers, and all aspects of e-commerce operations. This MCP server provides covering Medusa's core Admin API plus an additive Medusa v2 coverage tool: - - Products, variants, categories, tags, types - - List, get, cancel, complete, archive, transfer, fulfillment - - Cart-like functionality with line item management - - Customer CRUD, addresses, customer groups - - Collections CRUD, product associations - - Inventory items, stock locations, levels, reservations - - Regions, shipping options, profiles, fulfillment - - Price lists, promotions, campaigns - - Payment collections, captures, refunds - - Returns, swaps, claims,...
README
以下为原文 README 节选，完整内容请查看原文。
Medusa.js MCP Server
A comprehensive Model Context Protocol (MCP) server that provides automated API tools for Medusa e-commerce backend operations. This server exposes all major Medusa admin API functionality through MCP-compatible tools for use with AI assistants like Claude Desktop.
🏪 About Medusa.js
Medusa.js is a modern, open-source e-commerce platform built for developers. It provides a headless commerce backend with powerful admin APIs for managing products, orders, customers, and all aspects of e-commerce operations.
🚀 Features
Complete Admin API Coverage
This MCP server provides 15 admin tools covering Medusa’s core Admin API plus an additive Medusa v2 coverage tool:
- 🛍️ Products Management - Products, variants, categories, tags, types
- 📦 Orders Management - List, get, cancel, complete, archive, transfer, fulfillment
- 📋 Draft Orders - Cart-like functionality with line item management
- 👥 Customers Management - Customer CRUD, addresses, customer groups
- 📊 Collections Management - Collections CRUD, product associations
- 📈 Inventory Management - Inventory items, stock locations, levels, reservations
- 🌍 Regions & Shipping - Regions, shipping options, profiles, fulfillment
- 💰 Pricing & Promotions - Price lists, promotions, campaigns
- 💳 Payments & Refunds - Payment collections, captures, refunds
- 🔄 Returns & Exchanges - Returns, swaps, claims, order edits
- 🎁 Gift Cards - Gift card operations and balance management
- 📈 Tax Management - Tax rates and tax regions
- 📺 Sales Channels - Channel operations and product associations
- 👤 Users & Auth - User management, invites, API keys
Key Capabilities
- ✅ 200+ API actions across all Medusa admin endpoints
- ✅ Full CRUD operations for all major resources
- ✅ Advanced e-commerce operations (fulfillment, order edits, promotions)
- ✅ MCP-compatible for seamless AI assistant integration
- ✅ Zero installation required - run directly with npx
- ✅ Comprehensive error handling and validation
🚦 Quick Start
Prerequisites
- Node.js v18+ (v20+ recommended)
- Running Medusa.js backend server
- Medusa admin API key
Usage Modes
MCP Medusa supports three usage modes:
| Mode | Transport | Use Case | Best For |
|---|---|---|---|
| Local | STDIO | Direct IDE integration (npx) | Individual developers |
| Remote HTTP | Streamable HTTP | Web apps with LLM integration | Production web apps |
| Remote via mcp-remote | STDIO → HTTP bridge | IDEs connecting to remote server | Teams sharing one deployment |
Option 1: Local Mode (STDIO)
Best for: Individual developers using Claude Desktop, Windsurf, Cursor, or other MCP-compatible IDEs.
Direct integration running locally via npx - no server deployment needed.
Claude Desktop Configuration
安装
npx -y mcp-medusa配置
{
"mcpServers": {
"medusa-admin": {
"command": "npx",
"args": ["-y", "mcp-medusa"],
"env": {
"MEDUSA_BASE_URL": "http://localhost:9000",
"MEDUSA_API_KEY": "your_admin_api_key"
}
}
}
}