Loading...
Inoyu MCP Unomi server manages user profiles and context for Claude via Apache Unomi, enabling personalized and consistent interactions.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
Inoyu MCP Unomi server manages user profiles and context for Claude via Apache Unomi, enabling personalized and consistent interactions.
This MCP server offers useful profile management features but requires careful configuration of environment variables and CORS to prevent unauthorized access. It's relatively safe for read operations, but profile updates and consent modifications should be performed with caution.
Performance depends on the Unomi server's capacity. Optimize Unomi indexing for faster profile lookups and searches.
Cost depends on Unomi server resources and any associated cloud service costs. Monitor Unomi usage to avoid unexpected charges.
npm install
```{
"mcpServers": {
"unomi-server": {
"command": "npx",
"args": ["@inoyu/mcp-unomi-server"],
"env": {
"UNOMI_BASE_URL": "http://your-unomi-server:8181",
"UNOMI_VERSION": "3", // Use "2" for Unomi V2, "3" for Unomi V3 (default)
"UNOMI_USERNAME": "your-username", // Required for V2, fallback for V3
"UNOMI_PASSWORD": "your-password", // Required for V2, fallback for V3
"UNOMI_PROFILE_ID": "your-profile-id",
"UNOMI_KEY": "your-unomi-key", // Required for V2 only
"UNOMI_EMAIL": "your-email@example.com",
"UNOMI_SOURCE_ID": "claude-desktop",
"UNOMI_TENANT_ID": "your-tenant-id", // Required for V3
"UNOMI_PUBLIC_KEY": "your-public-key", // Required for V3
"UNOMI_PRIVATE_KEY": "your-private-key" // Required for V3
}
}
}
}UNOMI_BASE_URLUNOMI_USERNAMEUNOMI_PASSWORDUNOMI_PROFILE_IDUNOMI_SOURCE_IDUNOMI_KEYUNOMI_EMAILget_my_profileRetrieves the user's profile information using environment variables or email lookup.
Read-only operation; retrieves profile data.
update_my_profileUpdates properties of the user's profile with provided key-value pairs.
Modifies profile properties; potential for data corruption if not validated.
get_profileRetrieves a specific profile by its ID.
Read-only operation; retrieves profile data.
search_profilesSearches for profiles based on a query string across first name, last name, and email.
Read-only operation; searches profile data.
create_scopeCreates a new Unomi scope with a given identifier, name, and description.
Creates a new scope which can affect context isolation.
get_tenant_infoRetrieves information about the current tenant, including version and key status (V3 only).
Read-only operation; retrieves tenant information.
update_consentUpdates a user's consent status using the modifyConsent event.
Modifies user consent status; potential for privacy implications.
get_consentRetrieves specific consent information for a profile.
Read-only operation; retrieves consent data.
list_consentsLists all consents for a profile with optional filtering.
Read-only operation; lists consent data.
Environment Variable
local
This MCP server offers useful profile management features but requires careful configuration of environment variables and CORS to prevent unauthorized access. It's relatively safe for read operations, but profile updates and consent modifications should be performed with caution.
The server operates with the permissions granted by the Unomi API key and environment variables. Ensure these are properly configured to limit potential damage.
Production Tip
Regularly rotate Unomi API keys and monitor Unomi logs for suspicious activity.
Apache Unomi is a customer data platform (CDP) that provides profile management and personalization capabilities.
This server allows Claude to access and manage user profiles stored in Apache Unomi, enabling personalized interactions.
The server requires environment variables for Unomi base URL, username, password, profile ID, source ID, and API key.
Configure CORS in Unomi's `etc/org.apache.unomi.cors.cfg` file, adding your Claude Desktop origin.
The server first attempts to find a profile by email, falling back to the `UNOMI_PROFILE_ID` if no email is provided or no profile is found.
Scopes provide context isolation, allowing you to separate different applications or contexts within Unomi.
The server uses Unomi's Consent API to update and retrieve user consent status, supporting GDPR compliance.