Hiveflow MCP Server

🚀 @hiveflow/mcp-server

HiveFlowの公式モデルコンテキストプロトコル（MCP）サーバーです。AIアシスタント（Claude、Cursorなど）を直接HiveFlowオートメーションプラットフォームに接続できます。

🚀 クイックスタート

インストール

npm install -g @hiveflow/mcp-server

設定

MCPクライアントの設定ファイル（例：.cursor/mcp.json）に以下を追加します。

{
  "mcpServers": {
    "hiveflow": {
      "command": "npx",
      "args": ["-y", "@hiveflow/mcp-server"],
      "env": {
        "HIVEFLOW_API_KEY": "your-api-key-here",
        "HIVEFLOW_API_URL": "https://api.hiveflow.ai"
      }
    }
  }
}

ローカル開発用の設定

{
  "mcpServers": {
    "hiveflow": {
      "command": "npx",
      "args": ["-y", "@hiveflow/mcp-server"],
      "env": {
        "HIVEFLOW_API_KEY": "your-api-key-here",
        "HIVEFLOW_API_URL": "http://localhost:5000"
      }
    }
  }
}

🔑 APIキーの取得方法

オプション1: HiveFlowダッシュボードから

1. HiveFlowダッシュボードにログインします。
2. 設定 > APIキーに移動します。
3. 新しいAPIキーを生成します。

オプション2: コマンドラインから（セルフホスト）

cd your-hiveflow-backend
node get-api-key.js your-email@example.com

🛠️ 利用可能なツール

設定が完了すると、AIアシスタントで以下のツールを利用できます。

フロー管理

• create_flow - 新しいオートメーションフローを作成します。
• list_flows - すべてのフローを一覧表示します。
• get_flow - 特定のフローの詳細を取得します。
• execute_flow - オプションの入力を指定してフローを実行します。
• pause_flow - アクティブなフローを一時停止します。
• resume_flow - 一時停止したフローを再開します。
• get_flow_executions - 実行履歴を取得します。

MCPサーバー管理

• list_mcp_servers - 設定されたMCPサーバーを一覧表示します。
• create_mcp_server - 新しいMCPサーバーを登録します。

📊 利用可能なリソース

• hiveflow://flows - すべてのフローデータにアクセスします。
• hiveflow://mcp-servers - MCPサーバーの設定を表示します。
• hiveflow://executions - フローの実行履歴を表示します。

💻 使用例

基本的な使用法

新しいフローの作成

AI: "Create a flow called 'Email Processor' that analyzes incoming emails"

アクティブなフローの一覧表示

AI: "Show me all my active flows"

フローの実行

AI: "Execute the flow with ID 'abc123' with input data {email: 'test@example.com'}"

フローのステータスの取得

AI: "What's the status of my Email Processor flow?"

🔧 設定オプション

環境変数

• HIVEFLOW_API_KEY - HiveFlowのAPIキー（必須）
• HIVEFLOW_API_URL - HiveFlowインスタンスのURL（デフォルト: https://api.hiveflow.ai）
• HIVEFLOW_INSTANCE_ID - マルチテナント環境のインスタンスID（オプション）

コマンドラインオプション

hiveflow-mcp --api-key YOUR_KEY --api-url https://your-instance.com

🏗️ アーキテクチャ

このMCPサーバーは、AIアシスタントとHiveFlowの間のブリッジとして機能します。

AI Assistant (Claude/Cursor) ↔ MCP Server ↔ HiveFlow API

🔒 セキュリティ

• APIキーはHTTPSを通じて安全に送信されます。
• すべてのリクエストは認証と承認が行われます。
• MCPサーバーはローカルにデータを保存しません。

🐛 トラブルシューティング

一般的な問題

"HIVEFLOW_API_KEY is required"

• MCP設定でAPIキーが設定されていることを確認してください。
• APIキーが有効で期限切れでないことを確認してください。

"Cannot connect to HiveFlow API"

• HiveFlowインスタンスが起動していることを確認してください。
• API URLが正しいことを確認してください。
• ファイアウォールの制限がないことを確認してください。

"MCP server not found"

• AIアシスタントを完全に再起動してください。
• MCP設定ファイルが正しい場所にあることを確認してください。
• パッケージがインストールされていることを確認してください: npm list -g @hiveflow/mcp-server

デバッグモード

詳細なログを表示するには、以下の環境変数を設定します。

export DEBUG=hiveflow-mcp:*

📚 ドキュメント

• HiveFlowドキュメント
• MCPプロトコル仕様
• APIリファレンス

🤝 コントリビューション

コントリビューションを歓迎します！詳細はコントリビューションガイドを参照してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🆘 サポート

• GitHubの問題
• Discordコミュニティ
• メールサポート

Made with ❤️ by the HiveFlow team