Deployment Overview
The NAICS MCP Server can be deployed in various environments to suit your needs.
Deployment Options
| Option | Best For | Complexity |
|---|---|---|
| Docker | Single server, development | Low |
| Kubernetes | Production, high availability | Medium |
| Standalone | Development, testing | Low |
Quick Start
Docker (Recommended)
docker pull ghcr.io/mfbaig35r/naics-mcp-server:latest
docker run -p 9090:9090 ghcr.io/mfbaig35r/naics-mcp-server:latestStandalone
pip install naics-mcp-server
naics-mcp init
naics-mcp embeddings
naics-mcp serveArchitecture
┌─────────────────────────────────────────────────┐
│ MCP Client │
│ (Claude Desktop, Cursor, etc.) │
└────────────────────┬────────────────────────────┘
│ MCP Protocol (stdio/SSE)
▼
┌─────────────────────────────────────────────────┐
│ NAICS MCP Server │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Search │ │ Classify │ │ Workbook │ │
│ │ Engine │ │ Engine │ │ Store │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │
│ └─────────────┼─────────────┘ │
│ │ │
│ ┌──────────────────┴───────────────────────┐ │
│ │ SQLite Database │ │
│ │ • NAICS 2022 codes (2,125) │ │
│ │ • Index terms (20,398) │ │
│ │ • Embeddings (384-dim) │ │
│ └──────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘System Requirements
Minimum
- CPU: 1 core
- RAM: 512 MB
- Disk: 500 MB
- Python: 3.11+
Recommended
- CPU: 2+ cores
- RAM: 1 GB
- Disk: 1 GB
- Python: 3.11+
Health Checks
The server provides HTTP endpoints for health monitoring:
| Endpoint | Purpose | Status Codes |
|---|---|---|
/health | Liveness | 200 OK |
/ready | Readiness | 200 OK, 503 Not Ready |
/status | Detailed status | 200 OK |
/metrics | Prometheus metrics | 200 OK |
Configuration
See Configuration for environment variables and settings.
Next Steps
- Docker Deployment - Container deployment
- Kubernetes Deployment - Production deployment
- Configuration - Environment variables