使用说明

项目简介:

'sergehuber_inoyu-mcp-unomi-server' 是一个基于 Model Context Protocol (MCP) 构建的服务器，它作为 Claude 等 LLM 客户端的后端，利用 Apache Unomi 平台来管理用户画像 (profile) 和会话 (session)，从而为 LLM 应用提供用户上下文管理能力。

该项目旨在演示如何通过 MCP 服务器集成外部用户数据平台，使 LLM 能够记住用户偏好、维护用户状态，并在对话中保持上下文连贯性。

主要功能点:

用户画像管理: 基于 Apache Unomi 实现用户画像的创建、检索和更新，支持通过邮箱查找用户画像，并自动创建新用户画像。
会话管理: 自动生成基于日期的会话 ID，跟踪用户会话状态。
工具集成: 提供一系列工具 (Tools)，允许 LLM 客户端调用以访问和操作用户画像数据，例如：
- 'get_my_profile': 获取当前用户画像信息。
- 'update_my_profile': 更新当前用户画像属性。
- 'get_profile': 根据 Profile ID 获取指定用户画像。
- 'search_profiles': 搜索用户画像。
- 'create_scope': 创建 Unomi Scope (用于隔离上下文)。
Scope 管理: 支持 Unomi Scope 的自动创建和管理，用于隔离不同应用的上下文数据。
Claude 集成: 专门为 Claude Desktop 设计，提供简单的配置方式即可集成。

安装步骤:

前提条件:
- 确保已安装 Claude Desktop 客户端。
- 确保已安装并运行 Apache Unomi 服务器，并可以从运行 MCP 服务器的环境中访问。
配置 Claude Desktop:
- 根据你的操作系统，找到 Claude Desktop 的配置文件 'claude_desktop_config.json'：
  - macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  - Windows: '%APPDATA%/Claude/claude_desktop_config.json'
- 编辑该文件，在 'mcpServers' 字段中添加 'unomi-server' 的配置信息。

服务器配置:

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",  // Apache Unomi 服务器的 URL，例如 "http://localhost:8181"
        "UNOMI_USERNAME": "your-username",        // 访问 Unomi 服务器的用户名
        "UNOMI_PASSWORD": "your-password",        // 访问 Unomi 服务器的密码
        "UNOMI_PROFILE_ID": "your-profile-id",      // 默认的用户画像 ID，作为 fallback 使用
        "UNOMI_KEY": "your-unomi-key",           // Unomi 服务器的安全密钥，用于授权
        "UNOMI_EMAIL": "[email protected]",   // （可选）用户的邮箱地址，用于通过邮箱查找用户画像
        "UNOMI_SOURCE_ID": "claude-desktop"       // MCP 服务器的 Source ID，默认为 "claude-desktop"
      }
    }
  }
}

注意: 请将上述配置中的 'your-unomi-server:8181', 'your-username', 'your-password', 'your-profile-id', 'your-unomi-key', '[email protected]' 替换为你的实际 Unomi 服务器配置和用户信息。

基本使用方法:

重启 Claude Desktop 客户端，使配置生效。
在 Claude Desktop 的聊天窗口中，点击右下角的 "工具" 图标，确认 "unomi-server" 提供的工具已加载。
在与 Claude 的对话中，你可以指示 Claude 使用这些工具来获取或更新用户画像信息，例如：
- "Claude, 请使用 'get_my_profile' 工具获取我的用户画像信息。"
- "Claude, 请使用 'update_my_profile' 工具将我的名字更新为 '新名字'。"
- "Claude, 请使用 'search_profiles' 工具搜索包含关键词 'example' 的用户画像。"

关键词

使用说明

信息