A
securityA
licenseA
qualityEnables interaction with Shopify store data using the GraphQL API, supporting product, customer, and order management with comprehensive error handling.
Last updated -
15
496
11
TypeScript
MIT License
Connects GPT-4 to a merchant store API, allowing AI to query and update store data for a specific merchant, including listing stores, searching for relevant stores, and adding new stores with descriptions and tags.
AI_SYNC Tooling with OpenAI + MCP
This project connects GPT-4 to a backend merchant store API using the Model Context Protocol (MCP). It allows querying and updating store data under a specific merchant class.
⚠️ Note: The server is currently hardcoded to work with the
Tnc_Storemerchant ID. Only data under this class is accessible to the AI.
⚙️ Setup Instructions
1. Clone the Repository
2. Create a .env File
Inside the project root, create a .env file containing your OpenAI API key:
3. Set Up the Python Environment with uv
If you haven’t installed uv, do so with:
Then set up and activate the virtual environment:
This will automatically install dependencies based on the uv.lock file.
4. Start the Merchant API Server
Ensure the backend server (AI_SYNC) is running locally on:
Required POST endpoints:
/MerchantStore/findAllStores/MerchantStore/findStore/MerchantStore/addNewStore
5. Run the Tooling System
To launch the client and tool server together:
server.pyprovides tool definitions via MCPclient.pyconnects to GPT-4 and routes user queries
💬 Example Queries
⚠️ For multiline input, paste it as a single line. Shift+Enter will submit prematurely in most terminals.
📁 Basic Project Structure
✅ Available Tools
| Tool Name | Description |
|---|---|
findAllStores | List all stores for Tnc_Store |
findStore | Natural language search for relevant stores |
addNewStore | Add a store with full description and tags |
🔒 Notes
- Only data for
Tnc_Storeis accessible - Requires OpenAI GPT-4 (
gpt-4o) and a functioning backend API - Runs entirely locally using standard input/output
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Connects GPT-4 to a merchant store API, allowing users to query and manage store data for the Tnc_Store merchant through natural language interactions.
Related MCP Servers
- AsecurityAlicenseAqualityEnables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.Last updated -1549630TypeScriptMIT License
- -securityAlicense-qualityEnables interaction with Shopify stores through GraphQL API, providing tools for managing products, customers, orders, and more.Last updated -4968TypeScriptMIT License
- AsecurityAlicenseAqualityEnables interaction with Shopify store data through GraphQL API, providing tools for managing products, customers, orders, blogs, and articles.Last updated -15552TypeScriptMIT License