「Inoyu」MCP サーバーは何をするのか？

Inoyu MCP Unomi サーバーは、Anthropic の Model Context Protocol (MCP) と Apache Unomi カスタマーデータプラットフォーム (CDP) を統合する MCP サーバーです。Claude などの AI アシスタントが Unomi 内のユーザープロファイルとやりとり・管理できるようになり、文脈認識やセッションを跨いだ持続的なユーザーデータ管理が可能となります。サーバーはメールによるプロファイル検索と作成、プロファイルプロパティ管理、セッション管理、文脈分離のためのスコープ管理などをサポートします。これらの機能を MCP 経由で公開することで、AI エージェントがユーザー情報の取得・更新など高度なユーザーデータ操作を行え、持続的かつ文脈に富んだユーザーデータ管理を必要とする開発フローを強化します。

プロンプト一覧

リポジトリやドキュメントにはプロンプトテンプレートは記載されていません。

リソース一覧

明示的な MCP リソースはリポジトリファイルに記載されていません。

ツール一覧

• get_my_profile
  環境変数を使ってユーザープロファイルを取得します。セグメントやスコア情報の取得に対応し、現在の日付を使ったセッション ID も生成します。

• update_my_profile
  ユーザープロファイルのプロパティを更新します。文字列・数値・真偽値・null など多様なデータ型の key-value オブジェクトを受け付けます。

• get_profile
  Unomi から特定のプロファイル ID を指定して完全なプロファイルデータを取得します。

• search_profiles
  クエリ文字列を使ってプロファイルを検索します。オプションで limit や offset を指定可能。firstName, lastName, email 項目を横断的に検索します。

この MCP サーバーのユースケース

• パーソナライズされた AI 会話
  AI アシスタントがユーザーの名前・好み・サブスクリプション状況などを記憶・更新でき、セッションを跨いでよりパーソナライズされた体験を提供します。
• カスタマーデータ管理
  Unomi から顧客プロファイルを直接検索・更新・取得でき、開発者向けのカスタマーサポートや CRM ワークフローを効率化します。
• ユーザーセグメンテーションとターゲティング
  プロファイル・セグメント・スコア情報にアクセスし、AI 統合ワークフローを通じてユーザーのセグメント化やコンテンツ・オファーの最適化が可能です。
• 文脈に応じたセッション管理
  日付ベースの ID でセッション管理を自動化し、異なるやり取りやセッション間でユーザー文脈を保持・分離します。
• プロファイル検索と監査
  コンプライアンス・監査・分析目的でプロファイルを横断検索し、大規模なユーザーデータベースのプログラム的な管理を容易にします。

設定方法

Windsurf

Windsurf 用の具体的な設定手順はありません。

Claude

1. 前提条件を満たしていることを確認します（Node.js と npx）。
2. 設定ファイルの場所を確認します:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Inoyu MCP Unomi サーバーの設定を追加します:

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

4. 設定を保存します。
5. Claude Desktop を再起動し、サーバーやツールが認識されているか確認します。

API キーのセキュリティ確保

JSON 設定ファイルの env セクションで、機微な認証情報を環境変数として設定してください。

Cursor

Cursor 用の具体的な設定手順はありません。

Cline

Cline 用の具体的な設定手順はありません。

フロー内での MCP 利用方法

FlowHunt での MCP 利用

FlowHunt ワークフローに MCP サーバーを統合するには、MCP コンポーネントをフローに追加し、AI エージェントと接続します。

MCP コンポーネントをクリックして設定パネルを開き、システム MCP 設定セクションで以下の JSON 形式で MCP サーバー情報を入力します。

{
  "inoyu-unomi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AI エージェントはこの MCP をツールとして利用でき、すべての機能や操作にアクセスできます。“inoyu-unomi” は任意の名称に、URL もご自身の MCP サーバーアドレスに置き換えてください。

概要

総評

この MCP サーバーは、Apache Unomi と連携したユーザープロファイル管理に有用なツール群と、Claude Desktop 向けのシンプルなセットアップ手順を提供します。ただし、プロンプトテンプレートや明示的なリソース定義、Windsurf・Cursor・Cline 向けの手順がないため、現時点では網羅性が限定的です。現段階では実験や学習用途に適しています。

MCP スコア

評価: 6/10
Inoyu MCP Unomi サーバーは Unomi プロファイル管理や AI 統合に有望ですが、初期段階でリソースやプロンプトの詳細がなく、マルチプラットフォーム対応も限定的なため、現状では幅広い開発者向けの実用性はやや限定的です。