Sergehuber Inoyu MCP Unomi Server

🚀 Inoyu MCP-Unomi サーバー

Inoyu MCP-Unomi サーバーは、Unomi サービスと連携してデータ管理や分析を行うためのサーバーです。このサーバーを使用することで、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

高度な使用法

以下は、get_my_profile 関数を呼び出す例です。

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

🔧 技術詳細

環境変数の設定

機能特性

• API キーの自動取得：UNOMI_KEY 環境変数が手動で指定されていない場合、サーバーは Unomi から API アクセスキーを自動的に取得します。
• ログ記録：UNOMI_EMAIL 環境変数を使用してログ記録機能を構成でき、デバッグや問題のトラブルシューティングに役立ちます。

🐞 デバッグガイド

デバッグモードの起動

開発環境では、以下のコマンドを使用してデバッグモードを起動できます。

npm run debug unomi-server

実行状態の確認

以下のコマンドを実行して、サーバーの状態を確認します。

npm run status unomi-server

⚠️ トラブルシューティング

一般的な問題

1. Unomi サービスに接続できない

• UNOMI_BASE_URL が正しく構成されていることを確認してください。
• ネットワーク接続を確認し、そのアドレスにアクセスできることを確認してください。

2. 認証に失敗する

• UNOMI_USERNAME と UNOMI_PASSWORD が正しいことを確認してください。
• 非対話型モードを使用している場合は、Unomi サービスが匿名アクセスを許可していることを確認してください。

ログ分析

サーバーは実行中に詳細なログ情報を出力し、問題のトラブルシューティングに役立ちます。デフォルトでは、ログはコンソールに出力され、以下のコマンドを使用してファイルにリダイレクトすることができます。

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

🌟 高度な機能

自動構成

UNOMI_PROFILE_ID 環境変数を設定することで、サーバーは指定されたユーザーのデータ構成を自動的に読み込むことができます。

📄 注意事項

セキュリティに関する注意

• 本番環境では、パスワードやキーなどの機密情報を平文で保存しないでください。
• API キーを定期的に更新し、使用範囲を制限することをお勧めします。

パフォーマンス最適化

• 適切な接続プールサイズを構成し、データベースのボトルネックを回避します。
• キャッシュメカニズムを有効にして、データアクセスの効率を向上させます。

📞 連絡先

何か質問や提案がある場合は、your.email@example.com までご連絡ください。

Inoyu MCP-Unomi サーバーをご利用いただき、ありがとうございます！詳細なヘルプについては、公式ドキュメントと更新情報をご確認ください。