Inoyu Apache Unomi MCP Server

Overview

基本能力

产品定位

Inoyu Apache Unomi MCP Server 是一个中间件服务，用于在Claude和Apache Unomi之间建立桥梁，实现用户上下文的维护和管理。

核心功能

基于电子邮件的配置文件查找和自动创建
配置文件属性管理
基本的会话处理
上下文隔离的范围管理

适用场景

需要在Claude中维护用户偏好的场景
跨会话存储和检索用户特定信息的场景
通过电子邮件识别管理多个用户的场景

工具列表

get_my_profile - 使用环境变量获取您的配置文件
使用UNOMI_PROFILE_ID或电子邮件查找
自动生成基于当前日期的会话ID
可选参数包括requireSegments和requireScores
update_my_profile - 更新您的配置文件属性
使用UNOMI_PROFILE_ID或电子邮件查找
接受包含键值对的属性对象
get_profile - 通过ID检索特定配置文件
search_profiles - 搜索配置文件
接受查询字符串和可选的limit/offset参数
create_scope - 创建新的Unomi范围
接受范围标识符和可选的名称/描述

常见问题解答

受保护事件失败
验证Unomi密钥是否匹配
检查IP地址是否正确列入白名单
确保在更新属性之前范围存在
找不到配置文件
检查UNOMI_EMAIL是否正确设置
验证电子邮件格式是否有效
确保配置文件存在于Unomi中
会话问题
记住会话是基于日期的
每天每个配置文件只有一个会话
连接问题
验证Unomi服务器是否正在运行
检查网络连接

使用教程

使用依赖

运行中的Apache Unomi服务器
Claude Desktop安装
网络访问Unomi服务器
适当的安全配置
所需的环境变量

安装教程

在Claude Desktop中添加服务器配置和环境变量：
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
添加以下配置：

{
  "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": "[email protected]",
        "UNOMI_SOURCE_ID": "claude-desktop"
      }
    }
  }
}

更新配置后重启Claude Desktop

调试方式

使用MCP检查器进行调试：

npm run inspector

跟踪Claude Desktop日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

检查Unomi服务器日志：

$UNOMI_HOME/logs/karaf.log

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。