Back to the catalog

gpu-coordination

A zero-dependency MCP server to coordinate GPU usage across multiple agent instances.

Open source Open in the app JSON README (API)

About

A zero-dependency MCP server to coordinate GPU usage across multiple agent instances.

Details

Kind
Plugins
Topic
Developer tools
Publisher
tianhaoz95
Origin
gemini
Category
ferramentas
Version
1.0.0
Last push
2026-04-06T21:51:40Z
Repository state
ativo
Language
Python
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
tianhaoz95/mcp

README

# AI Hardware & Device Coordination MCP Servers

A set of zero-dependency MCP servers to coordinate shared hardware usage across multiple agent instances (Gemini CLI, Claude Code, etc.) on a single host.

## Tools Included

- **[GPU Coordination](./tools/gpu-coordination/README.md)**: Manages atomic locks for NVIDIA GPUs.
- **[Device Coordination](./tools/device-coordination/README.md)**: Manages atomic locks for Flutter mobile/web devices.

## Installation

### 🚀 Automated Installation (Gemini CLI)
Install directly from GitHub as a native extension:
```bash
gemini extensions install https://github.com/tianhaoz95/mcp
```
*This handles cloning and tool registration automatically.*

### 🛠️ Manual Installation (Claude Code & others)
1. **Clone the repository:**
   ```bash
   git clone https://github.com/tianhaoz95/mcp
   cd mcp
   ```
2. **Register the tools:**

   **For Claude Code (Global):**
   ```bash
   # GPU Coordination
   claude mcp add gpu-coordination python3 $(pwd)/tools/gpu-coordination/gpu_mcp_server.py --env GPU_COUNT=8 --scope user
   
   # Device Coordination
   claude mcp add device-coordination python3 $(pwd)/tools/device-coordination/device_mcp_server.py --scope user
   ```
   *Note: To limit these tools to a specific project, omit the `--scope user` flag.*

   **For Gemini CLI (Manual):**
   ```bash
   gemini mcp add gpu-coordination python3 $(pwd)/tools/gpu-coordination/gpu_mcp_server.py --env GPU_COUNT=8
   gemini mcp add device-coordination python3 $(pwd)/tools/device-coordination/device_mcp_server.py
   ```

## Features
- **Zero Dependency**: Only requires Python 3 (standard library).
- **Atomic Locking**: Prevents resource contention between agents.
- **Shared State**: All agents on the same host share the same inventory.
- **Auto-Release**: Prevents deadlocks if an agent crashes.

More