VendorOps MCP

VendorOps is a Model Context Protocol (MCP) server for a synthetic internal vendor-management workflow. It gives AI applications structured access to vendor records, contracts, spending, renewals, and security reviews.

The project is intentionally built in small, reviewable slices. Phase 1 uses Python, the official MCP Python SDK, SQLite, Pydantic, and pytest to expose read-only vendor data over a local stdio connection.

All vendor and contract data in this repository is synthetic.

Development

Install the locked dependencies:

uv sync

Run the test suite:

uv run pytest

Run the local stdio server:

uv run vendorops-mcp

The server waits for an MCP host to send protocol messages over stdin. It does not open a network port or print a user interface.

By default, VendorOps creates data/vendorops.db and seeds it with 30 synthetic vendors. Set VENDOROPS_DB_PATH to use a different SQLite file.

Current MCP Capabilities

Tools

• search_vendors: Search vendor records by name, category, or owner, with optional category and status filters.