sergehuber_inoyu-mcp-unomi-server

The Inoyu Apache Unomi MCP Server is a Model Context Protocol server designed to enable Claude to maintain user context through Apache Unomi's profile management system. This server allows for user recognition across conversations using email or profile ID, ensuring consistent user context between sessions. It supports profile lookup and creation, profile property management, and basic session handling. The server integrates seamlessly with Claude Desktop, providing automatic session management and scope-based context isolation. Users can store and retrieve preferences, manage multiple users, and maintain consistent user context. The server requires a running Apache Unomi server, Claude Desktop installation, network access to the Unomi server, and proper security configuration. Environment variables are used to configure the server, and it supports email-based profile lookup with automatic creation. The server is in early implementation and is intended for learning and experimentation.

Features

• {'name': 'Profile Access', 'description': 'Email-based profile lookup with automatic creation, profile properties, segments, and scores access, JSON format for all data exchange, automatic session management with date-based IDs.'}
• {'name': 'Tools', 'description': 'Includes tools like get_my_profile, update_my_profile, get_profile, search_profiles, and create_scope for managing profiles and scopes.'}
• {'name': 'Scope Management', 'description': 'Automatic management of scopes with default and custom scopes, ensuring context isolation and event tracking.'}

Usage with Different Platforms

Claude Desktop

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_USERNAME": "your-username",
        "UNOMI_PASSWORD": "your-password",
        "UNOMI_PROFILE_ID": "your-profile-id",
        "UNOMI_KEY": "your-unomi-key",
        "UNOMI_EMAIL": "your-email@example.com",
        "UNOMI_SOURCE_ID": "claude-desktop"
      }
    }
  }
}