Maximo MCP Server
This project implements an MCP Server for the IBM Maximo API. It provides a set of tools to interact with Maximo resources like Assets, Work Orders, etc.
High-Level Flow
- The MCP client sends a request to the MCP Server.
- The MCP Server receives the request and calls the appropriate tool function.
- The tool function makes a request to the Maximo API.
- The Maximo API returns a response to the tool function.
- The tool function returns the response to the MCP Server.
- The MCP Server returns the response to the MCP client.
Files
mcp_server.py: The main application file. It contains the Flask server and the tool implementations.requirements.txt: The project dependencies..env: The environment variables for the project.manifest.json: The tool manifest file.README.md: This file.
Tools
get_asset: Retrieves details of a specific asset by its ID.list_assets: Lists all assets, with optional filtering and pagination.
Note on HTTP Methods
The tool endpoints use the POST method to receive parameters in a JSON payload, which is a standard practice for MCP servers, even for operations that fetch data.
list_assets Parameters
page_size(optional, default: 10): The number of assets to return per page.page_num(optional, default: 1): The page number to return.where(optional): A filter to apply to the query. The value should be a valid Maximooslc.whereclause. For example, to filter for assets with a status of "OPERATING", you would use"status=\"OPERATING\"".
Running the Maximo AI Assistant
This project includes an interactive web application built with Streamlit that allows you to chat with an AI assistant powered by Gemini and your Maximo MCP server.
1. Set Up Environment
First, install the required Python packages:
pip install -r requirements.txt
You will also need to create a .env file in the root of the project with your Maximo and Google API keys:
MAXIMO_API_URL=https://your-maximo-instance.com
MAXIMO_API_KEY=your-maximo-api-key
GOOGLE_API_KEY=your-google-api-key
2. Run the MCP Server
In your first terminal, start the MCP server:
python mcp_server.py
The server will start on http://localhost:5001. Keep this terminal running.
3. Run the Streamlit App
In a new terminal window, run the Streamlit application:
streamlit run streamlit_app.py
The application will open in your web browser. You can now chat with the Maximo AI Assistant and ask it questions about your assets.