lineshopping-api-mcp

# 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](https://github.com/astral-sh/uv) (Python package manager) 3. LINE Shopping API Key (`X_API_KEY`) ## Installation 1. **Clone the repository:** ```sh git clone https://github.com/woraphol-j/lineshopping-api-mcp.git cd lineshopping-api-mcp ``` 2. **Install dependencies:** ```sh uv add fastmcp httpx ``` 3. **Create Environment File:** Create a `.env` file in the project root: ```env X_API_KEY=your_api_key_here ``` ## Configuration & Integration To use this MCP server with an agent platform, configure your agent to launch the server using `uv` and the correct environment variables. Example config (from `.vscode/mcp.json`): ```jsonc { "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 l…