IT Asset Tracker MCP Server

An MCP (Model Context Protocol) server that connects Claude Desktop to the IT Asset Tracker backend, giving Claude access to 70+ tools for managing assets, users, requests, and reports.

What it does

Lets you talk to your IT management system in plain English through Claude Desktop. For example:

• "Show me all pending electronics requests"
• "List all assets assigned to a user"
• "Give me a summary report of all assets"
• "Approve the laptop request from John"

Project structure

itassettracker/
├── server.py           # MCP server entry point
├── openapi_tools.py    # Auto-generates tools from the backend's OpenAPI schema
├── requirements.txt    # Python dependencies
├── .env                # Your credentials (not committed)
└── .env.template       # Template showing what goes in .env

Setup

1. Prerequisites

• Python 3.10 or higher
• Claude Desktop installed

2. Install dependencies

pip install -r requirements.txt

3. Configure credentials

Copy .env.template to .env and fill in your details:

cp .env.template .env

Edit .env:

BACKEND_BASE_URL=https://qk1ytdyqxb.execute-api.us-east-1.amazonaws.com
BACKEND_EMAIL=your_email@company.com
BACKEND_PASSWORD=your_password

Or if you prefer to use a bearer token directly:

BACKEND_BASE_URL=https://qk1ytdyqxb.execute-api.us-east-1.amazonaws.com
BACKEND_ACCESS_TOKEN=your_jwt_token_here

4. Test the server

python server.py

You should see:

BASE_URL = https://qk1ytdyqxb.execute-api.us-east-1.amazonaws.com
TOKEN EXISTS = True
INFO: Loaded 70 tools from .../openapi.json

5. Connect to Claude Desktop

Add this to your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "it-asset-tracker": {
      "command": "python",
      "args": ["/full/path/to/server.py"],
      "env": {
        "BACKEND_BASE_URL": "https://qk1ytdyqxb.execute-api.us-east-1.amazonaws.com",
        "BACKEND_ACCESS_TOKEN": ""
      }
    }
  }
}

Quit and relaunch Claude Desktop. You should see a 🔨 hammer icon in the chat input.

Authentication

The server supports three auth methods (in order of priority):

1. Bearer token in .env — set BACKEND_ACCESS_TOKEN
2. Email + password in .env — set BACKEND_EMAIL and BACKEND_PASSWORD, server auto-logs in on startup
3. Set token at runtime — tell Claude: "Set auth token to eyJhbGci..."

Tokens expire after ~24 hours. Using email + password in .env is recommended so login happens automatically.

How it works

On startup, the server fetches the backend's OpenAPI schema and automatically generates an MCP tool for every API endpoint. No manual tool definitions needed — adding a new endpoint to the backend automatically makes it available to Claude.