Add ACS MCP server

[AlexGodbehere]

Add MCP Server for AI Agent Integration

Summary

Adds @amrc-factoryplus/mcp, a Model Context Protocol (MCP) server that enables AI agents like Claude and Cursor to interact with Factory+ services.

What's New

New package: acs-mcp/ - An MCP server published as @amrc-factoryplus/mcp

Features

ConfigDB Tools (read-only)

Tool	Description
list_apps	List all registered applications
get_config	Fetch config by app UUID and object UUID
list_configs	List all objects with config for an application
search_configs	Search configs with JSONPath query
get_class_members	List all members of a class (recursive)
get_class_subclasses	List all subclasses of a class (recursive)
get_object_info	Get registration and general info for an object

Auth Tools (read-only)

Tool	Description
list_principals	List all principal UUIDs
find_principal	Find info by Kerberos/UUID/Sparkplug ID
check_acl	Check if a principal has a permission on a target
list_grants	List all permission grant UUIDs
get_grant	Get details of a specific grant
find_grants	Search grants by principal/permission/target
whoami	Get current authenticated identity

Directory Tools (read-only)

Tool	Description
get_device_info	Get device details (address, schemas, online status)
get_device_address	Get Sparkplug address for a device UUID
get_service_info	Get full service registration (URL + device)
get_service_url	Get HTTP endpoint URL for a service UUID

Documentation Tools

Tool	Description
search_docs	Search ACS documentation on GitHub
list_docs	List available documentation files
read_doc	Read a specific documentation file
search_portal	Search Factory+ documentation portal
read_portal_page	Read a Factory+ portal page

Usage

npx -y @amrc-factoryplus/mcp

Configure in MCP client:

{
  "acs": {
    "command": "/path/to/npx",
    "args": ["-y", "@amrc-factoryplus/mcp"],
    "env": {
      "PATH": "/path/to/node/bin:/usr/bin:/bin",
      "DIRECTORY_URL": "https://directory.example.com",
      "SERVICE_USERNAME": "service-account",
      "SERVICE_PASSWORD": "..."
    }
  }
}

[amrc-benmorrow]

🤷 The F+ bits look OK. I have no clue about the MCP bits.