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_Store merchant 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.py provides tool definitions via MCP
• client.py connects 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_Store is accessible
• Requires OpenAI GPT-4 (gpt-4o) and a functioning backend API
• Runs entirely locally using standard input/output

---