# ibmspectrumcomputing/lsf-mcp-server architecture

> Architecture diagram of the GitHub repository ibmspectrumcomputing/lsf-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ibmspectrumcomputing/lsf-mcp-server
- Repository: https://github.com/ibmspectrumcomputing/lsf-mcp-server

## Overview

This is a local MCP server that exposes IBM Spectrum LSF job management, cluster inspection, and remote file operations. An MCP client invokes the server over stdio; the server dispatches tool calls to the relevant domain handler, which authenticates and uses the HTTP client to call the LSF REST API. A typical user workflow uploads inputs, submits and monitors a job, then downloads results, but the README describes that as user orchestration rather than an internal pipeline. The README and excerpts establish the main links; unsampled implementation details are omitted.

Main entry points: [`src/lsf_mcp_server/server.py`](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/server.py) (MCP Server), [`src/lsf_mcp_server/lsf_client.py`](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/lsf_client.py) (REST Client), [`src/lsf_mcp_server/auth.py`](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/auth.py) (Authentication), [`src/lsf_mcp_server/tools/files.py`](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/files.py) (File Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP Interface"]
  node_server["MCP Server<br/>[server.py]"]
end

subgraph group_domains["LSF Operations"]
  node_jobs["Job Management<br/>[jobs.py]"]
  node_cluster["Cluster Information<br/>[cluster.py]"]
  node_files["File Operations<br/>[files.py]"]
end

subgraph group_connectivity["API Connectivity"]
  node_auth["Authentication<br/>[auth.py]"]
  node_client["REST Client<br/>[lsf_client.py]"]
end

subgraph group_contracts["Request Models"]
  node_models["Request Models<br/>[models.py]"]
end

node_mcp_client(("MCP Client"))
node_lsf_api["LSF REST API"]
node_local_files["Local Files"]

node_mcp_client -->|"calls tools"| node_server
node_server -->|"dispatches jobs"| node_jobs
node_server -->|"dispatches queries"| node_cluster
node_server -->|"dispatches files"| node_files
node_server -->|"initializes"| node_client
node_server -->|"initializes"| node_auth
node_jobs -->|"ensures login"| node_auth
node_jobs -->|"sends requests"| node_client
node_cluster -->|"ensures login"| node_auth
node_cluster -->|"sends requests"| node_client
node_files -->|"ensures login"| node_auth
node_files -->|"sends requests"| node_client
node_auth -->|"sets token"| node_client
node_client -->|"HTTP requests"| node_lsf_api
node_files -->|"reads and writes"| node_local_files

click node_server "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/server.py"
click node_jobs "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/jobs.py"
click node_cluster "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/cluster.py"
click node_files "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/files.py"
click node_auth "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/auth.py"
click node_client "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/lsf_client.py"
click node_models "https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_mcp_client toneBlue
class node_jobs,node_cluster,node_files toneAmber
class node_auth,node_client,node_lsf_api toneMint
class node_models toneRose
class node_local_files toneIndigo
```

## Components

### MCP Interface

- [MCP Server](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/server.py): `src/lsf_mcp_server/server.py`

### LSF Operations

- [Job Management](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/jobs.py): `src/lsf_mcp_server/tools/jobs.py`
- [Cluster Information](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/cluster.py): `src/lsf_mcp_server/tools/cluster.py`
- [File Operations](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/tools/files.py): `src/lsf_mcp_server/tools/files.py`

### API Connectivity

- [Authentication](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/auth.py): `src/lsf_mcp_server/auth.py`
- [REST Client](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/lsf_client.py): `src/lsf_mcp_server/lsf_client.py`

### Request Models

- [Request Models](https://github.com/ibmspectrumcomputing/lsf-mcp-server/blob/main/src/lsf_mcp_server/models.py): `src/lsf_mcp_server/models.py`

### Other components

- **MCP Client**
- **LSF REST API**
- **Local Files**

## Connections

- MCP Client → MCP Server: calls tools (evidence: `README.md`)
- MCP Server → Job Management: dispatches jobs (evidence: `src/lsf_mcp_server/server.py`)
- MCP Server → Cluster Information: dispatches queries (evidence: `src/lsf_mcp_server/server.py`)
- MCP Server → File Operations: dispatches files (evidence: `src/lsf_mcp_server/server.py`)
- MCP Server → REST Client: initializes (evidence: `src/lsf_mcp_server/server.py`)
- MCP Server → Authentication: initializes (evidence: `src/lsf_mcp_server/server.py`)
- Job Management → Authentication: ensures login (evidence: `src/lsf_mcp_server/tools/jobs.py`)
- Job Management → REST Client: sends requests (evidence: `src/lsf_mcp_server/tools/jobs.py`)
- Cluster Information → Authentication: ensures login (evidence: `src/lsf_mcp_server/tools/cluster.py`)
- Cluster Information → REST Client: sends requests (evidence: `src/lsf_mcp_server/tools/cluster.py`)
- File Operations → Authentication: ensures login (evidence: `src/lsf_mcp_server/tools/files.py`)
- File Operations → REST Client: sends requests (evidence: `src/lsf_mcp_server/tools/files.py`)
- Authentication → REST Client: sets token (evidence: `src/lsf_mcp_server/auth.py`)
- REST Client → LSF REST API: HTTP requests (evidence: `README.md`)
- File Operations → Local Files: reads and writes (evidence: `src/lsf_mcp_server/tools/files.py`)
