Sergehuber Inoyu MCP Unomi Server

🚀 Inoyu MCP-Unomi 服務器

Inoyu MCP-Unomi 服務器是一個便捷的工具，可幫助用戶與 Unomi 服務進行交互。它支持自動獲取 API 密鑰、日誌記錄等功能，方便開發和調試。

🚀 快速開始

要使用 Inoyu MCP-Unomi 服務器，首先需要安裝項目依賴，然後進行相應的配置。

📦 安裝指南

運行以下命令安裝項目依賴：

npm install @inoyu/mcp-unomi-server --save-dev

📚 詳細文檔

配置指南

創建或編輯配置文件

在下列位置創建或編輯配置文件：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

添加以下服務器配置，使用 NPX 指令運行最新版本的服務器：

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

若需使用特定版本，可配置如下：

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server@0.1.0"],
      "env": {
        // ... 環境變量配置 ...
      }
    }
  }
}

對於本地開發環境，可指定本地構建文件：

{
  "mcpServers": {
    "unomi-server": {
      "command": "node",
      "args": ["/path/to/local/mcp-unomi-server/build/index.js"],
      "env": {
        // ... 環境變量配置 ...
      }
    }
  }
}

使用說明

基本命令

1. 安裝依賴：

npm install @inoyu/mcp-unomi-server --save-dev

2. 運行服務器（開發環境）：

npm run dev unomi-server

3. 構建生產包：

npm run build unomi-server

4. 調試服務器：

npm run debug unomi-server

環境變量配置

功能特性

• 自動獲取 API 密鑰：當未手動指定 UNOMI_KEY 環境變量時，服務器將自動從 Unomi 獲取 API 訪問密鑰。
• 日誌記錄：支持通過 UNOMI_EMAIL 環境變量配置日誌記錄功能，便於調試和問題排查。

調試指南

啟動調試模式

在開發環境下，可以通過以下命令啟動調試模式：

npm run debug unomi-server

檢查運行狀態

運行以下命令查看服務器狀態：

npm run status unomi-server

故障排除

常見問題

• 無法連接到 Unomi 服務
  • 確保 UNOMI_BASE_URL 配置正確。
  • 檢查網絡連接，確保可以訪問該地址。
• 認證失敗
  • 確認 UNOMI_USERNAME 和 UNOMI_PASSWORD 正確無誤。
  • 若使用的是非交互式方式，請檢查 Unomi 服務是否允許匿名訪問。

日誌分析

服務器運行時會輸出詳細的日誌信息，便於排查問題。默認情況下，日誌輸出到控制檯，並可通過以下命令重定向到文件：

npm run debug unomi-server > debug.log 2>&1

高級功能

自動配置

通過設置 UNOMI_PROFILE_ID 環境變量，服務器可以自動加載指定用戶的數據配置。

API 調用示例

以下是一個調用 get_my_profile 函數的示例：

const profile = await getMyProfile();
console.log(profile);

⚠️ 注意事項

安全提示

• 請勿在生產環境中明文存儲敏感信息，如密碼和密鑰。
• 建議定期更新 API 密鑰，並限制其使用範圍。

性能優化

• 配置合適的連接池大小，避免數據庫瓶頸。
• 啟用緩存機制，提高數據訪問效率。

附錄

環境變量參考表

命令行工具

• 狀態檢查

npm run status unomi-server

• 日誌輸出

npm run logs unomi-server

• 服務重啟

npm run restart unomi-server

項目聯繫人

如有任何問題或建議，請聯繫：your.email@example.com

感謝使用 Inoyu MCP-Unomi 服務器！如需更多幫助，敬請關注我們的官方文檔和更新。