Inoyu Apache Unomi MCP Server

⚠️ 注意：这是一个早期实现，仅用于学习和实验目的。

概述

Inoyu Apache Unomi MCP 服务器使 Claude 能够通过 Apache Unomi 维护用户上下文，实现跨会话的用户信息记忆和管理。

快速安装

1. 在 Claude Desktop 配置文件中添加 MCP 服务器设置：

   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": "your-email@example.com",
           "UNOMI_SOURCE_ID": "claude-desktop"
         }
       }
     }
   }
   

2. 确保您有一个运行中的 Apache Unomi 服务器

3. 重启 Claude Desktop

4. 点击聊天窗口右下角的工具图标，确认服务器提供的工具已被识别

核心功能

• 用户识别：通过电子邮件或ID识别用户
• 配置文件管理：存储和检索用户配置信息
• 上下文保持：在会话之间维持用户上下文

可用工具

• get_my_profile：获取当前用户配置文件
• update_my_profile：更新用户属性，例如：

  {
    "properties": {
      "firstName": "John",
      "age": 30,
      "isSubscribed": true
    }
  }
  

• get_profile：通过ID获取特定配置文件
• search_profiles：搜索用户配置文件
• create_scope：创建新的上下文作用域

Unomi 服务器配置

在 Unomi 的 etc/org.apache.unomi.cluster.cfg 中设置：

org.apache.unomi.cluster.authorization.key=your-unomi-key
org.apache.unomi.ip.ranges=127.0.0.1,::1,your-claude-desktop-ip

在 etc/org.apache.unomi.cors.cfg 中设置：

org.apache.unomi.cors.allowed.origins=http://localhost:*

调试

使用内置的 MCP Inspector 工具进行调试：

npm run inspector

---

📌 注意：更改配置后，请务必重启 Claude Desktop。详细文档请参考项目仓库。