Ayx MCP Wrapper

🚀 AYX-MCP-Wrapper

Model Context Protocol (MCP) サーバーで、Alteryx サーバーとの包括的なインターフェースを提供します。このラッパーを使用すると、AIアシスタントやその他のMCPクライアントが、ワークフロー、コレクション、ユーザー、スケジュール、資格情報などを管理するためにAlteryxサーバーとやり取りできます。

🚀 クイックスタート

この AYX-MCP-Wrapper は、Alteryx サーバーとのインタラクションを容易にするための Model Context Protocol (MCP) サーバーです。以下の手順に従ってセットアップし、始めましょう。

✨ 主な機能

• 高度な検索：柔軟な検索オプションでユーザー、ワークフロー、アセットを見つけることができます。
• ワークフロー操作：ワークフローの実行、転送、管理を完全にコントロールできます。
• ワークフローアセット：ワークフローパッケージをダウンロードし、XMLを抽出して分析することができます。
• ジョブ監視：ワークフローの実行ジョブをリアルタイムで追跡および管理できます。
• コレクション管理：コレクションの作成、更新、削除、整理を行うことができます。
• ユーザー管理：ユーザー、そのアセット、およびパーミッションを効率的に管理できます。
• スケジュール管理：ワークフローのスケジュールと自動化を作成および管理できます。
• 資格情報管理：サーバーの資格情報を処理し、安全な接続を確立できます。

📦 インストール

uv を使用したクイックスタート (推奨)

# まだuvをインストールしていない場合は、以下のコマンドでインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh

# MCPサーバーをインストールします。
uv pip install mcp-server-alteryx

pip を使用する場合

pip install mcp-server-alteryx

ソースからインストールする場合

git clone https://github.com/jupiterbak/AYX-MCP-Wrapper.git
cd AYX-MCP-Wrapper
uv sync
uv run pip install -e .

📚 ドキュメント

環境変数の設定

環境変数を使用してサーバーの資格情報を設定します。

# 必須: サーバーAPIのURL
export ALTERYX_API_HOST="https://your-server.com/webapi/"

# 必須: OAuth2クライアントの資格情報
export ALTERYX_CLIENT_ID="your-client-id"
export ALTERYX_CLIENT_SECRET="your-client-secret"

# オプション: SSL検証 (デフォルト: true)
export ALTERYX_VERIFY_SSL="1"

# オプション: 一時フォルダ
export ALTERYX_TEMP_DIRECTORY="your-temp-directory"

# オプション: ログレベル
export LOG_LEVEL="INFO"

設定ファイルの使用

または、プロジェクトのルートに .env ファイルを作成することもできます。

ALTERYX_API_HOST=https://your-server.com/webapi/
ALTERYX_CLIENT_ID=your-client-id
ALTERYX_CLIENT_SECRET=your-client-secret
ALTERYX_VERIFY_SSL=1
ALTERYX_TEMP_DIRECTORY=your-temp-directory
LOG_LEVEL=INFO

💻 使用例

Claude Desktop との統合

このMCPサーバーをClaude Desktopとともに使用するには、Claude Desktopの設定に以下の構成を追加します。

{
  "mcpServers": {
    "alteryx": {
      "command": "uvx",
      "args": ["mcp-server-alteryx", "--transport", "stdio"],
      "env": {
        "ALTERYX_API_HOST": "https://your-server.com/webapi/",
        "ALTERYX_CLIENT_ID": "your-client-id",
        "ALTERYX_CLIENT_SECRET": "your-client-secret",
        "ALTERYX_VERIFY_SSL": "1",
        "ALTERYX_TEMP_DIRECTORY": "your-temp-directory"
      }
    }
  }
}

ただし、「Sequential Thinking」ツールと組み合わせて使用することをお勧めします。

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "alteryx": {
      "command": "uvx",
      "args": ["mcp-server-alteryx", "--transport", "stdio"],
      "env": {
        "ALTERYX_API_HOST": "http://localhost/webapi/",
        "ALTERYX_CLIENT_ID": "your-client-id",
        "ALTERYX_CLIENT_SECRET": "your-client-secret",
        "ALTERYX_VERIFY_SSL": "1",
        "ALTERYX_TEMP_DIRECTORY": "your-temp-directory"
      }
    }
  }
}

構成オプション:

• command: 使用するuvx実行可能ファイル
• args: MCPサーバーのコマンドライン引数
• env: サーバー認証のための環境変数

トランスポートオプション:

• stdio: 標準入出力 (Claude Desktopで推奨)
• sse: サーバー送信イベント
• streamable-http: HTTPストリーミング

Cursor IDE との統合

Cursor IDEと統合するには、Cursorの設定に以下を追加します。

{
  "mcpServers": {
    "alteryx": {
      "command": "uvx",
      "args": ["mcp-server-alteryx", "--transport", "stdio"],
      "env": {
        "ALTERYX_API_HOST": "https://your-alteryx-server.com/webapi/",
        "ALTERYX_CLIENT_ID": "your-client-id",
        "ALTERYX_CLIENT_SECRET": "your-client-secret",
        "ALTERYX_TEMP_DIRECTORY": "your-temp-directory"
      }
    }
  }
}

コマンドラインインターフェース

MCPサーバーは、さまざまなトランスポートオプションで実行できます。

# stdioトランスポートを使用する (デフォルト)
uvx run src.main --transport stdio

# サーバー送信イベント (SSE) を使用する
uvx run src.main --transport sse

# HTTPストリーミングを使用する
uvx run src.main --transport streamable-http

# ログレベルを設定する
uvx run src.main --log-level DEBUG

# カスタム設定で実行する
uvx run src.main --transport stdio --log-level INFO

利用可能なツール

MCPサーバーは、機能別に整理された包括的なツールを提供します。

コレクション管理

ワークフロー操作

ユーザー管理

スケジュール管理

ジョブ監視

資格情報と接続

🔧 技術詳細

開発環境のセットアップ

# リポジトリをクローンします。
git clone https://github.com/jupiterbak/AYX-MCP-Wrapper.git
cd AYX-MCP-Wrapper

# 依存関係をインストールします。
uv sync

# 開発モードでインストールします。
uv run pip install -e .

🤝 コントリビューション

コントリビューションを歓迎します！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

関連プロジェクト

• Model Context Protocol - MCP仕様
• Claude Desktop - Claude Desktopアプリケーション

コミュニティのために愛を込めて作られました ❤️