ShopBot AI MCP

ShopBot exposes order-status lookup and knowledge-base answers through a local Python MCP server backed by a store database and RAG pipeline.

Local serverstdioPython

What is the ShopBot AI MCP Server?

ShopBot exposes order-status lookup and knowledge-base answers through a local Python MCP server backed by a store database and RAG pipeline.

Answer store-support questions

The server exposes two implemented tools: check_order_status and search_knowledge_base. Order lookup reads product, status, order time and tracking information from a configured SQL database. The knowledge tool uses text files from the repository's knowledge_base directory. It does not implement placing orders, cancelling purchases or issuing refunds.

Prepare both backing services

DB_CONNECTION_STRING configures the SQLAlchemy database connection. The RAG implementation uses Google's embedding and chat integrations, not an OpenAI pipeline. It builds or loads a local FAISS index from the knowledge files. The project uses SDK 1 FastMCP imports, so install compatible dependencies or migrate those imports before launching the local stdio script. Use only a FAISS index you created or trust because the source enables deserialization when loading it.

Verify a test order and policy

Start with a test order in a database you control. Compare the returned tracking and status fields with the row, then ask a policy question answered explicitly by a knowledge file. Check the retrieved answer against that file. Database access and model access need their own credentials; an MCP connection does not prove that either backing service is configured or that an answer matches current store policy.

Project documentation

Repository and setup guide

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
check_order_statusRead status and tracking for an order.
search_knowledge_baseAnswer a question using the configured knowledge base.

How to install the ShopBot AI MCP Server

{
  "mcpServers": {
    "shopbot": {
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH/shopbot-ai/mcp/shopbot_server.py"
      ],
      "env": {
        "DB_CONNECTION_STRING": "YOUR_DATABASE_CONNECTION_STRING"
      }
    }
  }
}

Configuration

The project Python dependencies, compatible MCP SDK 1 imports, an orders database, Google model credentials and prepared knowledge-base files.

VariableDescriptionRequired
DB_CONNECTION_STRINGSQLAlchemy connection string for the store database.Yes

Frequently asked questions

The inspected tools read order status and answer knowledge-base questions. Purchase and refund actions are not implemented by those tools.