TM1 MCP Server
About
A Python-based Model Context Protocol (MCP) server that enables compatible LLMs to control and interact with IBM TM1 instances. It provides easy access to TM1 through MCP, a collection of useful TM1 tools and utilities, and a simple mechanism for adding custom tools.
Details
- Author
- andreyea
- Downloads
- 287
- Categories
- Other
Jump to
- Easy access to TM1 instances through MCP
- Collection of useful TM1 tools and utilities
- Simple extension mechanism for adding custom tools
- Built with Python 3.12+ and TM1py
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
TM1 MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies, then modify the TM1 connection parameters in config.py as required. Run the server with uv run main.py or use the MCP inspector with mcp dev main.py. For Claude Desktop, configure %APPDATA%/Claude/claude_desktop_config.json with the command uv --directory /ABSOLUTE/PATH/TO/TM1MCP run main.py.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"tm1 mcp server": {
"tm1mcp": {
"command": "uv",
"args": [
"run",
"main.py"
]
}
}
}
}McpServers
{
"tm1mcp": {
"command": "uv",
"args": [
"run",
"main.py"
]
}
}TM1 MCP Server
A Python-based project that provides a MCP server for controlling and interacting with IBM TM1 instances using any compatible LLM
Features
- Easy access to TM1 instances through MCP
- Collection of useful TM1 tools and utilities
- Simple extension mechanism for adding custom tools
Requirements
- Python 3.12+
- TM1 instance accessible via TM1py
- Dependencies as specified in pyproject.toml
- uv
Installation
1. Clone this repository
2. Install dependencies
Configuration
Modify the TM1 connection parameters in config.py as required
Usage
Run the server:
uv run main.py
Run MCP inspector:
mcp dev main.py
Sample config for Claude Desktop (%APPDATA%/Claude/claude_desktop_config.json)
Note: Update directory arg where you save this project
{
"mcpServers": {
"tm1": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/TM1MCP",
"run",
"main.py"
]
}
}
}
Extending
Add new tools by:
1. Creating new modules in the tools/ directory
2. Decorating functions with @mcp.tool()
3. Importing your modules in main.py
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
