allpets_mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@allpets_mcpshow me this week's dashboard"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
allpets_mcp
Fully self-contained MCP server for AllPets Clinic & Beyond analytics. All business logic lives inside this repo — no dependency on any sibling folder at runtime.
Setup (one-time)
cd C:\Users\sathv\Desktop\allpets_mcp
# Create venv
python -m venv venv
# Install dependencies
.\venv\Scripts\pip.exe install -r requirements.txt
# Fill in credentials (already populated for local dev)
notepad .envRelated MCP server: Metrx MCP Server
Local test
# Dev inspector — opens browser UI to call tools manually
.\venv\Scripts\python.exe -m mcp dev server.py
# Or run directly (exits immediately in stdio mode — expected)
.\venv\Scripts\python.exe server.pyClaude Desktop setup
Open
%APPDATA%\Claude\claude_desktop_config.jsonAdd the
allpetsentry inside"mcpServers":
{
"mcpServers": {
"allpets": {
"command": "C:\\Users\\sathv\\Desktop\\allpets_mcp\\venv\\Scripts\\python.exe",
"args": ["C:\\Users\\sathv\\Desktop\\allpets_mcp\\server.py"]
}
}
}Restart Claude Desktop completely (quit and reopen).
The tool icon appears in the chat input — click it to see the 4 AllPets tools.
Phase 1 tools
Tool | What it does |
| Returns this ISO week's Monday/Sunday |
| Returns the current calendar month and boundaries |
| Full KPI dashboard for a date range |
| Full KPI dashboard for a YYYY-MM calendar month |
| Freeform NL2SQL question |
| Weekly dashboard as .xlsx |
| Monthly dashboard as .xlsx |
Project structure
allpets_mcp/
├── server.py ← Entry point (stdio MCP server)
├── config.py ← DB engine + env loading (self-contained)
├── dashboard_queries.py ← Pre-computed weekly KPI engine
├── nl2sql_agent.py ← 5-step LangGraph NL2SQL pipeline
├── sql_dynamic_agent.py ← SQL generation + retry (~1970 lines)
├── excel_export.py ← openpyxl report generator
├── etc/secrets/
│ └── schema_all.txt ← Full DB schema DDL (used by SQL agent)
├── adapters/
│ ├── dashboard.py ← Wraps DashboardService.run_weekly()
│ ├── analytics.py ← Wraps nl2sql_agent.run_agent()
│ └── excel.py ← Wraps generate_excel() → base64
├── tools/
│ ├── dashboard.py ← get_weekly_dashboard, get_current_week_dates
│ ├── analytics.py ← ask_analytics
│ └── reports.py ← generate_excel_report
├── .env ← All credentials (DB + OpenAI)
└── requirements.txtUpdating business logic
When dashboard_queries.py, nl2sql_agent.py, sql_dynamic_agent.py, or excel_export.py
change in allpets_new_schema, copy the updated file here:
Copy-Item ..\allpets_new_schema\dashboard_queries.py .\dashboard_queries.py -Force
Copy-Item ..\allpets_new_schema\nl2sql_agent.py .\nl2sql_agent.py -Force
Copy-Item ..\allpets_new_schema\sql_dynamic_agent.py .\sql_dynamic_agent.py -Force
Copy-Item ..\allpets_new_schema\excel_export.py .\excel_export.py -Force
Copy-Item ..\allpets_new_schema\etc\secrets\schema_all.txt .\etc\secrets\schema_all.txt -ForceThis server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for querying and analyzing data from ad platforms, analytics tools, and spreadsheets
Hosted MCP server for Google Ads and LinkedIn Ads analysis.
Marketing intelligence MCP server providing campaign performance data and analytics tools.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn open-source MCP server that connects to various data sources (SQL databases, CSV, Parquet files), allowing AI models to execute SQL queries and generate data visualizations for analytics and business intelligence.1275MIT
- AlicenseAqualityCmaintenanceAn MCP server for Metrx — provides tools for construction, healthcare, logistics, manufacturing, and legal mid-market businesses to query and analyze their operational data via AI.2341 npm2MIT
- AlicenseAqualityDmaintenanceMCP server for Adobe Customer Journey Analytics, enabling AI-powered analytics queries including reports, breakdowns, trends, and dimension searches through Claude and other MCP clients.16MIT
- AlicenseNot gradedqualityBmaintenanceA read-only MCP server that connects to a pet-grooming database, exposing secure analytics tools for customers, pets, appointments, services, and payments.MIT