Inoyu MCP Unomi 服务器集成

通过 Inoyu MCP Unomi 服务器，将 Anthropic Claude 与 Apache Unomi 连接，让您的 AI 可进行持久且富含上下文的用户数据管理。

AI MCP Server User Data Profile Management

“Inoyu” MCP 服务器的作用是什么？

Inoyu MCP Unomi 服务器是一款将 Anthropic 的模型上下文协议（MCP）与 Apache Unomi 客户数据平台（CDP）集成的 MCP 服务器。这使得如 Claude 等 AI 助手能够在 Unomi 中交互和管理用户画像，实现上下文感知和会话间持久化用户数据。该服务器支持通过邮件查找和创建画像、画像属性管理、会话处理与作用域管理，实现上下文隔离。通过 MCP 暴露这些能力，Inoyu 服务器让 AI 代理能够执行高级用户数据操作，如检索或更新用户信息，从而提升需要持久且富含上下文的用户数据管理的开发流程。

提示词列表

在仓库或文档中未列出任何提示词模板。

资源列表

可用仓库文件中未记录或列出任何明确的 MCP 资源。

工具列表

get_my_profile
通过环境变量获取用户画像。支持获取分群和评分信息，并根据当前日期生成会话ID。
update_my_profile
更新用户画像属性。接受带有键值对的属性对象，支持多种数据类型（字符串、数字、布尔、null）。
get_profile
通过ID从 Unomi 获取指定画像，并返回完整画像数据。
search_profiles
基于查询字符串搜索画像，支持可选的 limit 和 offset 参数。可在 firstName、lastName 和 email 字段中进行搜索。

该 MCP 服务器的应用场景

个性化 AI 对话
让 AI 助手能够记住并更新用户信息（如姓名、偏好或订阅状态），在多次会话中实现更个性化的体验。
客户数据管理
便捷地直接从 Unomi 查找、更新或获取客户画像，帮助开发者优化客户支持和 CRM 流程。
用户分群与定向
提供画像、分群和评分访问能力，开发者可据此对用户分群，并通过 AI 流程定制内容或优惠。
上下文会话处理
通过基于日期的ID自动化管理会话，确保不同交互或会话间用户上下文的保留与隔离。
画像搜索与审计
支持为合规、审计或分析目的跨画像搜索，便于以编程方式管理大型用户数据库。

如何设置

Windsurf

未提供 Windsurf 相关说明。

Claude

确保已满足前置条件（Node.js 与 npx）。
找到配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
添加 Inoyu MCP Unomi 服务器配置：

{
  "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"
      }
    }
  }
}

保存配置。
重启 Claude Desktop 以应用更改并确认服务器/工具被检测到。

API 密钥安全

请在 JSON 配置的 env 部分设置敏感凭据为环境变量。

Cursor

未提供 Cursor 相关说明。

Cline

未提供 Cline 相关说明。

在流程中如何使用该 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到 FlowHunt 工作流中，请首先在流程中添加 MCP 组件，并将其连接到您的 AI 代理：

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分，按照以下 JSON 格式填入您的 MCP 服务器信息：

{
  "inoyu-unomi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具使用该 MCP，并获得其全部功能。请注意将 “inoyu-unomi” 替换为您实际想用的名称，并将 URL 替换为您的 MCP 服务器地址。

概览

部分	可用性	备注
概览	✅	提供概览及功能总结
提示词列表	⛔	未列出任何提示词模板
资源列表	⛔	未记录明确资源
工具列表	✅	有四个工具：get_my_profile、update_my_profile 等
API 密钥安全	✅	提供了 Claude 的 JSON 环境变量示例
采样支持（评估时不重要）	⛔	未提及

我们的看法

该 MCP 服务器为基于 Apache Unomi 的用户画像管理提供了良好的集成，具有清晰的工具集并支持 Claude Desktop 的直观设置。然而，缺少提示词模板、明确的资源定义，以及对 Windsurf、Cursor、Cline 等平台的专属说明，导致整体完整性不足。目前更适合实验和学习用途。