Inoyu Apache Unomi MCP Server

This is a Model Context Protocol (MCP) server that allows Claude to maintain user context by leveraging Apache Unomi for profile management. It's an early implementation intended for demonstration, learning, and experimentation purposes.

Current Scope: Profile lookup/creation via email, profile property management, basic session handling, and scope management for context isolation. Other Unomi features are not yet implemented.

Installation: Requires configuring Claude Desktop with server details and environment variables (Unomi URL, credentials, profile ID, key, email, source ID).

Features:

• Profile Access: Email-based lookup, access to properties/segments/scores, JSON data exchange, and automatic session management.
• Tools: get_my_profile, update_my_profile, get_profile, search_profiles, and create_scope.
• Scope Management: Automatic management of scopes, including a default scope (claude-desktop) and custom scopes.

Overview: Enables Claude to recognize users, manage context, and integrate seamlessly with Claude Desktop.

Prerequisites: Running Apache Unomi server, Claude Desktop, network access, proper security, and environment variables.

Configuration: Requires setting environment variables and configuring Unomi server for protected events and CORS.

Development: Instructions for installing dependencies, building the server, and debugging.

Troubleshooting: Common issues, logs to check, and quick fixes.