Skip to Content
Getting Started

Getting Started

Get the NAICS MCP Server up and running in minutes.

Prerequisites

  • Python 3.11 or higher
  • An MCP-compatible client (e.g., Claude Desktop, Cursor)

Installation

docker pull ghcr.io/mfbaig35r/naics-mcp-server:latest
 
docker run -p 9090:9090 ghcr.io/mfbaig35r/naics-mcp-server:latest

Option 2: pip

pip install naics-mcp-server
 
# Initialize the database
naics-mcp init
 
# Generate embeddings (takes a few minutes)
naics-mcp embeddings
 
# Run the server
naics-mcp serve

Option 3: From Source

git clone https://github.com/mfbaig35r/naics-mcp-server.git
cd naics-mcp-server
pip install -e .
 
naics-mcp init
naics-mcp embeddings
naics-mcp serve

Configure Your MCP Client

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "naics": {
      "command": "naics-mcp",
      "args": ["serve"]
    }
  }
}

Or with Docker:

{
  "mcpServers": {
    "naics": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/mfbaig35r/naics-mcp-server:latest"]
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "naics": {
    "command": "naics-mcp",
    "args": ["serve"]
  }
}

Verify Installation

Once configured, you can verify the server is working by asking your AI assistant:

“Check the NAICS server health”

The assistant should use the get_server_health tool and return component status.

Next Steps

IntroductionFor Humans