Maximo MCP Ai Integration Options

🚀 マキシモMCPサーバー

AIを活用したIBM Maximoの開発を実現するサーバーです。AIアシスタントをIBM Maximo環境に直接接続し、APIの探索やデータのクエリ、コード生成を効率的に行えます。

作者: Markus van Kempen
メール: mvankempen@ca.ibm.com | markus.van.kempen@gmail.com
日付: 2026年2月5日

クイックスタート • ドキュメント • ライブデモ • ユースケース

🚀 クイックスタート

前提条件

• Node.js v18以上
• 読み取りアクセス権を持つ Maximo APIキー
• MCPをサポートするAI IDE（Antigravity、Cursor、VS Code + Continue）

インストール

方法1: npxで直接実行（推奨）

npx maximo-mcp-server

方法2: ソースからクローン

# リポジトリをクローン
git clone https://github.com/markusvankempen/maximo-mcp-ai-integration-options.git
cd maximo-mcp-ai-integration-options

# 依存関係をインストール
npm install

# 環境変数を設定
cp .env.example .env
# .envをMaximoの資格情報で編集

環境構成

.envファイルをMaximoの資格情報で編集します。

# .env（このファイルは決してコミットしないでください！）
MAXIMO_URL=https://your-maximo-host.com/maximo/api
MAXIMO_HOST=https://your-maximo-host.com
MAXIMO_API_KEY=your-api-key-here
MAXIMO_OPENAPI_PATH=./maximo_openapi.json
PORT=3002

OpenAPIスキーマのダウンロード（推奨）

OpenAPIスキーマファイルを使用すると、オフラインでのスキーマ検索が可能になり、AIの応答が高速化されます。

# Maximoインスタンスからダウンロード
curl -X GET "https://your-maximo-host.com/maximo/oslc/oas/api" \
     -H "apikey:your-api-key-here" \
     -o maximo_openapi.json

あるいは、Swagger UIを通じてダウンロードすることもできます。https://your-host/maximo/oslc/oas/api.html（「Explore」または「Download」をクリック）

方法3: ブラウザから直接ダウンロード（手動） curlが失敗した場合（SSL/ネットワークエラーなど）、手動でファイルをダウンロードすることができます。

1. ブラウザでこのURLを開きます。 https://[YOUR_MAXIMO_HOST]/maximo/oslc/oas/api （[YOUR_MAXIMO_HOST]を実際のサーバーアドレスに置き換えてください）
2. Maximoにログインするように求められる場合があります。
3. JSONが読み込まれたら、ページを右クリックして「ページを名前を付けて保存」を選択します。
4. ファイルをmaximo_openapi.jsonとしてプロジェクトのルートフォルダに保存します。

注意: このファイルのサイズは約12MBで、Maximoインスタンスのすべてのオブジェクト構造定義が含まれています。

IDEの構成

Google Antigravity（手動設定が必要）

⚠️ 注意: AntigravityのMCPストアは選別されており、レジストリからサーバーを自動検出しません。このサーバーを手動で追加する必要があります。

1. Antigravityを開きます。
2. エージェントパネルの上部にある「...」ドロップダウンをクリックします。
3. 「MCP Servers」→「Manage MCP Servers」→「View raw config」を選択します。
4. mcp_config.jsonに以下を追加します。

{
  "mcpServers": {
    "maximo-mcp-server": {
      "command": "npx",
      "args": ["-y", "maximo-mcp-server"],
      "env": {
        "MAXIMO_URL": "https://your-maximo-host/maximo/api",
        "MAXIMO_API_KEY": "your-api-key-here",
        "MAXIMO_HOST": "https://your-maximo-host"
      }
    }
  }
}

5. 保存して「Refresh」をクリックします。

Cursor / Claude Desktop

# テンプレートをコピー
cp config/mcp_config.json.example ~/.cursor/mcp.json
# またはClaude Desktopの場合:
cp config/mcp_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json

Maximoの資格情報で編集します。

{
  "mcpServers": {
    "maximo-mcp-server": {
      "command": "npx",
      "args": ["-y", "maximo-mcp-server"],
      "env": {
        "MAXIMO_URL": "https://your-maximo-host/maximo/api",
        "MAXIMO_API_KEY": "your-api-key-here"
      }
    }
  }
}

接続の確認

AI IDEで以下の質問をします。

"Is the Maximo MCP server connected?"

AIがget_instance_detailsを呼び出し、接続を確認します。

✨ 主な機能

マキシモMCPサーバー は、モデルコンテキストプロトコル サーバーで、AIアシスタント（Antigravity、Cursor、VS Code Copilotなど）を直接IBM Maximo環境に接続します。APIドキュメントを手動でコピーする代わりに、AIは以下のことができます。

📚 ドキュメント

コアガイド

フランス語翻訳

Wordドキュメント

すべてのガイドは、オフラインでの閲覧と共有のためにdocs/フォルダに.docx形式でも利用可能です。

🎬 ライブデモ

アセットマネージャーアプリケーション

自然言語プロンプトとMCPサーバーのみを使用して、完全な マキシモアセットマネージャー Webアプリケーションを構築しました。

デモの機能

🎥 スクリーンレコーディング

完全なビデオデモが利用可能です。

自分で試す

# ローカルプロキシサーバーを起動
node server.js

# ブラウザで開く
open http://localhost:3002/demos/assets.html

🛠 利用可能なMCPツール

サーバーはAIに6つのツールを公開しています。

💡 ユースケース

1. API呼び出しの生成

"Get me the last 10 approved work orders from BEDFORD site"

AIがget_schema_details(MXWO)を呼び出し、フィールドを理解して以下を生成します。

GET /maximo/api/os/mxwo
    ?oslc.where=status="APPR" and siteid="BEDFORD"
    &oslc.select=wonum,description,status,reportdate
    &oslc.orderBy=-reportdate
    &oslc.pageSize=10
    &lean=1

2. Pythonスクリプトの生成

"Write a Python script to export all Priority 1 work orders to CSV"

import requests
import csv

response = requests.get(
    "https://your-host/maximo/api/os/mxwo",
    params={"oslc.where": "wopriority=1", "lean": 1},
    headers={"apikey": "YOUR_KEY"}
)

with open("priority1_workorders.csv", "w") as f:
    writer = csv.DictWriter(f, fieldnames=["wonum", "description"])
    writer.writeheader()
    writer.writerows(response.json()["member"])

3. SQLクエリの生成

"Write SQL to find overdue work orders"

SELECT wonum, description, status, targcompdate
FROM workorder
WHERE status NOT IN ('COMP', 'CLOSE', 'CAN')
  AND targcompdate < CURRENT_DATE;

4. 完全なアプリケーションの構築

"Create an HTML dashboard to display assets"

結果: 以下の機能を備えた完全なWebアプリケーション。

• グラスモーフィズムを持つダークテーマ
• 検索とフィルター機能
• インタラクティブな詳細パネル
• Maximoからの事前読み込みデータ

詳細なウォークスルーについては、アセットマネージャーケーススタディ を参照してください。

📁 プロジェクト構造

Maximo-MCP/
├── maximo-mcp-server.js       # 🔌 MCPサーバーの実装
├── server.js                  # 🌐 CORS用のローカルプロキシサーバー
├── package.json               # 📦 依存関係
├── README.md                  # このファイル
├── .env.example               # 環境テンプレート
├── .gitignore                 # Gitの無視ルール
│
├── docs/                      # 📚 ドキュメント
│   ├── Maximo_MCP_Server_Guide.md         # 完全なMCPガイド
│   ├── Maximo_API_Interaction_Guide.md    # APIインタラクションパターン
│   ├── Asset_Manager_App_Case_Study.md    # 構築ウォークスルー
│   ├── Maximo_MCP_Server_Guide_FR.md      # フランス語翻訳
│   └── Maximo_API_Interaction_Guide_FR.md # フランス語翻訳
│
├── demos/                     # 🎨 デモアプリケーション
│   ├── assets.html                        # アセットマネージャーアプリ
│   ├── carbon_workorders.html             # Carbonテーブルデモ
│   └── index.html                         # APIビジュアライゼーションデモ
│
├── images/                    # 📸 スクリーンショットとレコーディング
│   ├── assets_demo_recording.webp         # 完全なデモレコーディング
│   ├── assets_loaded.png                  # ダッシュボードのスクリーンショット
│   ├── pump_search_results.png            # 検索デモ
│   └── laredo_filtered.png                # フィルターデモ
│
└── config/                    # ⚙️ 構成テンプレート
    └── mcp_config.json.example            # MCP構成テンプレート

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

🤝 コントリビューション

コントリビューションは大歓迎です！PRを提出する前に、コントリビューションガイドラインを読んでください。

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 ファイルを参照してください。

🙏 謝辞

• モデルコンテキストプロトコル のMCP仕様
• IBM Maximo のエンタープライズアセット管理プラットフォーム
• Carbon Design System のUIコンポーネント