UOFastMCP

Enterprise MCP server for U2 UniData/UniVerse — JWT auth, RBAC, audit logging, built-in admin UI to simplify the setup process.

Developer: RokiPark · License: MIT · Python: 3.11+

Install & Run

# 1. Create a folder and virtual environment
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

# 2. Install
pip install uofast-mcp

# 3. Set required env var
export JWT_SECRET_KEY=$(python -c "import secrets; print(secrets.token_hex(32))")
# Windows: set JWT_SECRET_KEY=<paste output of above>

# 4. Start
uofast-mcp

Server starts at http://localhost:8000

First-Time Setup

1. Open http://localhost:8000/admin
2. Log in: admin / changeme123!

3. Click Server Setup in the left menu

4. Follow the 5-step wizard:
   • Check prerequisites
   • Set JWT secret + change admin password
   • Configure your U2 connection (with live test)
   • Review generated .env and unidata_config.ini
   • Copy your Claude / VSCode / CLI connection config

Connect Claude

Important: UOFastMCP is an HTTP/SSE server — it must be connected to via URL, not launched as a subprocess command. Configuring it as a command ("command": "uofast-mcp") will cause a port conflict if the server is already running.

Step 1 — Start the server

uofast-mcp

Keep this running in a terminal. The server must be running before any client connects.

Step 2 — Get your connection token

Open http://localhost:8000/auth/login, log in, and copy the Authorization token shown — or generate it manually:

python -c "import base64; print(base64.b64encode(b'admin:changeme123!').encode().decode())"

Step 3 — Register with your client

Claude Code CLI / VSCode extension

claude mcp add --transport sse UOFastMCP http://localhost:8000/sse \
  --header "Authorization: Basic <your-base64-token>"

This writes the config automatically. To verify it was added:

claude mcp list

VSCode — manual config (.vscode/mcp.json or user settings.json)

{
  "servers": {
    "UOFastMCP": {
      "type": "sse",
      "url": "http://localhost:8000/sse",
      "headers": {
        "Authorization": "Basic <your-base64-token>"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "UOFastMCP": {
      "url": "http://localhost:8000/sse",
      "headers": {
        "Authorization": "Basic <your-base64-token>"
      }
    }
  }
}

Troubleshooting: "port already in use" / "Error during MCP server startup"

This error means the client is trying to launch uofast-mcp as a subprocess instead of connecting to the running server.

Cause: The server is registered as "command": "uofast-mcp" in your MCP config instead of as a URL.

Fix: Remove the command-based entry and re-add it using the claude mcp add --transport sse command above. Then restart the server:

# Windows
taskkill /F /IM python.exe
uofast-mcp

# macOS / Linux
pkill -f uofast-mcp
uofast-mcp

MCP Tools (20 tools)

Roles

Manage users and permissions at http://localhost:8000/admin.

Admin UI

http://localhost:8000/admin — login with admin credentials.

Environment Variables

API Endpoints

Troubleshooting

Server won't start — JWT_SECRET_KEY not set, or port 8000 in use (uvicorn uofast_mcp.app:app --port 8001).

401 Unauthorized — get credentials from /auth/login.

403 Forbidden — user's role lacks the required permission; check Admin → Role Permissions.

U2 connection fails — re-run Server Setup wizard to update credentials and test live.

Reset everything — delete data/security.db and restart (loses all users and audit logs).

License

MIT — © 2025 RokiPark. All rights reserved.