MCP Сервер для API LINE Shopping, позволяющий агентам и инструментам ИИ взаимодействовать с данными и операциями LINE Shopping через протокол Model Context. Этот сервер предоставляет инструменты для управления продуктами, запасами, заказами, расчетами и многим другим, используя официальный API LINE Shopping.

Особенности

Управление производством: Поиск, создание, обновление и удаление продуктов и вариантов ** Управление запасами**: Корректировать, увеличивать или уменьшать уровни запасов ** Управление заказами**: Запрос, просмотр, отмена и обновление заказов Урегулирование: Возврат деталей урегулирования для заказов Интеграция OpenAPI: все инструменты автоматически генерируются из спецификации OpenAPI

Предпосылки

1 Python >= 3.13 2. uv (управляющий пакетами Python) 3. LINE Shopping API Key ([T0])

##Установка

Метод 1: Использование uvx

Установите и запустите непосредственно из PyPI, используя uvx:

Или работать с переменными среды:

Оригинальное название: Method 2: Clone and Run

1. **Клон хранилища: **

2.** Установить зависимости:**

3. ** Запустите сервер: **

Конфигурация среды

Для постоянной настройки создайте файл .env в рабочем каталоге:

Конфигурация и интеграция

Использование uvx (PyPI Installation)

LINE Shopping API MCP Server

MCP Server for the LINE Shopping API, enabling AI agents and tools to interact with LINE Shopping data and operations via the Model Context Protocol. This server provides tools for managing products, inventory, orders, settlements, and more, using the official LINE Shopping API.

Features

• Product Management: Search, create, update, and delete products and variants
• Inventory Management: Adjust, increase, or decrease inventory levels
• Order Management: Query, view, cancel, and update orders
• Settlement: Retrieve settlement details for orders
• OpenAPI Integration: All tools are auto-generated from the OpenAPI spec

Prerequisites

1. Python >= 3.13
2. uv (Python package manager)
3. LINE Shopping API Key (X_API_KEY)

Installation

Method 1: Using uvx (Recommended)

Install and run directly from PyPI using uvx:

# Install and run the MCP server (note the different executable name)
uvx --from lineshopping-api-mcp lineshopping-mcp

Or run with environment variables:

# Set your API key and run
X_API_KEY=your_api_key_here uvx --from lineshopping-api-mcp lineshopping-mcp

Method 2: Clone and Run

1. Clone the repository:

   git clone https://github.com/woraphol-j/lineshopping-api-mcp.git
   cd lineshopping-api-mcp
   

2. Install dependencies:

   uv add fastmcp httpx
   

3. Run the server:

   # Set your API key and run
   X_API_KEY=your_api_key_here uv run --with fastmcp fastmcp run app.py
   

Environment Configuration

For persistent configuration, create a .env file in your working directory:

X_API_KEY=your_api_key_here

Configuration & Integration

Using uvx (PyPI Installation)

Configure your agent to use the PyPI-installed package:

{
	"inputs": [
		{
			"type": "promptString",
			"id": "line-shopping-api-key",
			"description": "LINE Shopping API Key",
			"password": true
		}
	],
	"servers": {
		"LINE Shopping API MCP": {
			"command": "uvx",
			"args": [
				"--from",
				"lineshopping-api-mcp",
				"lineshopping-mcp"
			],
			"env": {
				"X_API_KEY": "${input:line-shopping-api-key}"
			}
		}
	}
}

Using Local Clone

For local development or cloned repository:

{
	"inputs": [
		{
			"type": "promptString",
			"id": "line-shopping-api-key",
			"description": "LINE Shopping API Key",
			"password": true
		}
	],
	"servers": {
		"LINE Shopping API MCP": {
			"command": "uv",
			"args": [
				"run",
				"--with",
				"fastmcp",
				"fastmcp",
				"run",
				"/Users/xxx/lineshopping-api-mcp/app.py"
			],
			"env": {
				"X_API_KEY": "${input:line-shopping-api-key}",
				"FASTMCP_EXPERIMENTAL_ENABLE_NEW_OPENAPI_PARSER": "true"
			}
		}
	}
}

Available Tools

The following tools are exposed by the MCP server (see openapi.json for full details):

Checkout & Links

• create-checkout-link: Generate a checkout link for order items