Inoyu MCP Unomi Server

🚀 Inoyu MCP Unomi Server の日本語設定ガイド

Inoyu MCP Unomi Serverは、Unomi（Apache CXSプロジェクト）とのインタラクションに使用されるMCPプロトコルアダプターです。このドキュメントでは、このサーバーのインストール、設定、および使用方法について詳しく説明します。

🚀 クイックスタート

Inoyu MCP Unomi Serverを使用することで、Unomiとのインタラクションを容易に行うことができます。以下の手順に従って、サーバーをインストール、設定、および起動しましょう。

✨ 主な機能

• Unomiとのインタラクションを容易にするMCPプロトコルアダプターとして機能します。
• 環境変数を使用した柔軟な設定が可能です。
• 基本的な使用方法から高度なセキュリティ設定まで、様々なシナリオに対応しています。

📦 インストール

最新バージョンをnpmを通じてインストールします。

npm install -g @inoyu/mcp-unomi-server

特定のバージョンを指定する場合は、以下のコマンドを実行します。

npm install -g @inoyu/mcp-unomi-server@0.1.0

💻 使用例

基本的な使用法

サーバーを起動する基本的なコマンドです。

# 基本使用
npx @inoyu/mcp-unomi-server

高度な使用法

環境変数を指定してサーバーを起動します。

# 指定环境变量
UNOMI_BASE_URL=http://localhost:8181 \
UNOMI_USERNAME=admin \
UNOMI_PASSWORD=secret \
npx @inoyu/mcp-unomi-server

📚 ドキュメント

MCPサーバーの設定

環境変数

必要な環境変数とその説明を以下に示します。

設定オプション

セッションID形式

get_my_profile メソッドで生成されるセッションIDのデフォルト形式は以下の通りです。

[profileId]-YYYYMMDD

例えば、profileIdが user123 で、現在の日付が2024年3月15日の場合、セッションIDは user123-20240315 となります。

デバッグ

MCPサーバーは標準入出力を通じて通信するため、デバッグが難しい場合があります。MCP Inspector を使用してデバッグを支援することをおすすめします。

npm run inspector

また、Claude Desktopのログを確認することもできます。

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

# Windows
tail -n 20 -f %APPDATA%\Claude\mcp*.log

トラブルシューティング

一般的な問題

1. 保護されたイベントが失敗する

   • Unomiキーが両方の設定で完全に一致していることを確認してください。
   • UnomiにアクセスできるIPアドレスが許可されていることを確認してください。
   • 対象のコンテキストが正しく登録されていることを確認してください。

2. 接続問題

   • Unomiサービスが実行中で、ネットワークからアクセス可能であることを確認してください。
   • ファイアウォール設定を確認し、ポートがブロックされていないことを確認してください。

3. 設定エラー

   • すべての必須環境変数が正しく設定されていることを確認してください。
   • profileIdがUnomiのユーザーレコードと一致することを確認してください。

高度なトピック

セキュリティのベストプラクティス

• 本番環境では UNOMI_KEY を有効にして通信を暗号化します。
• Unomiとの通信をHTTPSで保護します。
• 定期的にキーをローテーションし、不正なアクセス試行を監視します。

ログと監視

• ログ管理ツール（ELKシリーズなど）を使用して、MCPサーバーのログを集中管理します。
• リクエスト成功率や遅延などの重要な指標を監視します。

サンプル設定

以下は完全な package.json のサンプルです。

{
  "name": "mcp-unomi-server",
  "version": "1.0.0",
  "scripts": {
    "start": "npx @inoyu/mcp-unomi-server"
  },
  "dependencies": {
    "@inoyu/mcp-unomi-server": "^0.1.0"
  }
}

まとめ

このドキュメントを通じて、Inoyu MCP Unomi Serverを設定して実行できるようになるはずです。まだ疑問がある場合や問題が発生した場合は、MCPプロトコルドキュメント を参照するか、コミュニティサポートに問い合わせてください。