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
git clone https://github.com/your-org/ai_sync
cd ai_sync
2. Create a .env File
Inside the project root, create a .env file containing your OpenAI API key:
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. Set Up the Python Environment with uv
If you haven’t installed uv, do so with:
curl -Ls https://astral.sh/uv/install.sh | sh
Then set up and activate the virtual environment:
uv venv .venv
source .venv/bin/activate
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:
http://localhost:4001
Required POST endpoints:
/MerchantStore/findAllStores/MerchantStore/findStore/MerchantStore/addNewStore
5. Run the Tooling System
To launch the client and tool server together:
uv run client.py server.py
server.pyprovides tool definitions via MCPclient.pyconnects to GPT-4 and routes user queries
💬 Example Queries
Query: Show me all the stores for this merchant
Query: I want to add a new store, CGV Cinemas - Vincom Nguyễn Chí Thanh, Hà Nội, with keywords: CGV, rạp chiếu phim, Hà Nội, Vincom, giải trí
⚠️ For multiline input, paste it as a single line. Shift+Enter will submit prematurely in most terminals.
📁 Basic Project Structure
ai_sync/
├── client.py # MCP + OpenAI chat client
├── server.py # Tool server using FastMCP
├── .env # OpenAI API key
├── uv.lock # Dependency lock file (used by uv)
✅ 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