Mcp
Connects AI assistants to QCDatabase.AI for everyday construction quality-control work.
WARNING! Our apologies, but some of the modifications we made to allow remote hosting of this MCP server have broken the stdio tools. We are working on a fix ASAP. Please check back here later.
QC Database MCP Server
A small program that lets an AI assistant (like Claude) do your everyday QC Database work for you — set the project you're working on, upload records, read what the AI pulled off a document, and find and close out the items still needed for a complete, traceable turnover package.
It runs on your own computer. Your AI assistant talks to it; it talks to QCDatabase.AI on your behalf, using your own login.
Built on the official Model Context Protocol
Python library and the QC Database MCP specification — published at
qcdatabase.ai/mcp_server_spec.md and
kept in this repo as mcp_server_spec.md.
What you can ask your assistant to do
Once it's connected, you can talk to it in plain language. For example:
- "Connect to QC Database." → signs you in (opens your browser once).
- "Work on the Riverside Unit 2 project." → pins that project for the session.
- "Upload this MTR to the Mill Test Reports folder."
- "What's still missing for turnover on this project?"
- "Show me the open reference requests assigned to me."
- "Find welds that failed X-ray near line 12." → meaning-based (semantic) search across your project data, ranked by relevance.
- "How do I create a test package in QC Database?" → answers from the built-in QC Database user manual, so you can learn the app without leaving your assistant.
- "Attach this photo to that weld."
- "Mark this inspection complete." (it will remind you that the sign-off is recorded under your name — that's your call, not the AI's).
Before you start
You need Python 3.10 or newer on your computer.
- Windows: install from the Microsoft Store (search "Python") or from python.org/downloads. During the python.org install, tick "Add Python to PATH."
- Mac:
brew install pythonor get it from python.org/downloads.
To check it's installed, open a terminal (PowerShell on Windows, Terminal on Mac) and run:
python --version
You should see Python 3.10 or higher. (On some Macs the command is python3.)
Install
From a terminal, in this folder:
pip install .
That's it. This installs the server and a command called qcdatabase-mcp.
If
pipisn't found, trypython -m pip install .(orpython3 -m pip install .).
Install in Claude Desktop
Claude Desktop launches this server for you and shows its tools in your chats. Set it up once:
1. Install the Claude Desktop app
If you don't have it, download it from claude.ai/download and sign in.
2. Open the config file
In Claude Desktop:
- Open Settings (Windows: menu ☰ → File → Settings; Mac: Claude → Settings).
- Go to the Developer tab.
- Click Edit Config.
This opens (and, if needed, creates) a file named claude_desktop_config.json.
You can also open it directly:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
3. Add the QC Database server
Put this in the file. If the file already has other servers, just add the
"qcdatabase" block inside the existing "mcpServers" section.
Windows:
{
"mcpServers": {
"qcdatabase": {
"command": "python",
"args": ["-m", "qcdatabase_mcp"]
}
}
}
Mac (Python is usually python3 there):
{
"mcpServers": {
"qcdatabase": {
"command": "python3",
"args": ["-m", "qcdatabase_mcp"]
}
}
}
Save the file.
From the project's README.