DEVHUB MCP Server

Connect your AI coding assistant (Claude Code, Cursor, GitHub Copilot, JetBrains AI, Cline, Windsurf) to your DEVHUB instance. Manage issues, sprints, comments, tasks, and attachments directly from your IDE.

npm: @mblogik/devhub-mcp-server | Full setup guide: docs/mcp-setup-guide.md

Quick Start

1. Get your API token

Go to your DEVHUB portal → Profile → API Tokens → Generate a token and copy it.

2. Add the MCP server to your AI tool

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "devhub": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Or add via CLI:

claude mcp add devhub -e DEVHUB_API_URL=https://devopshub.campusmaster.cloud -e DEVHUB_API_TOKEN=your-token -- npx -y @mblogik/devhub-mcp-server

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "devhub": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Or go to Settings → MCP Servers → Add Server and enter the details above.

GitHub Copilot (VS Code)

Add to .vscode/mcp.json:

{
  "servers": {
    "devhub": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Cline / Roo Code (VS Code)

Open the extension sidebar → MCP Servers (gear icon) → Configure MCP Servers, then add:

{
  "mcpServers": {
    "devhub": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "your-token-here"
      }
    }
  }
}

JetBrains IDEs (IntelliJ, PhpStorm, WebStorm, etc.)

Add to .junie/mcp.json in your project root, or go to Settings → Tools → AI Assistant → MCP Servers → Add:

{
  "mcpServers": {
    "devhub": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Requires JetBrains 2025.1+ with the AI Assistant plugin enabled.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "devhub": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "your-token-here"
      }
    }
  }
}

3. Start using it

Once connected, your AI assistant can interact with DEVHUB. Try asking:

• "Show me my open issues"
• "Create a hotfix issue for the login bug in project MAINT"
• "What are the P1 issues assigned to Kennedy?"
• "Add a comment to issue 15 saying the fix is deployed"
• "List the sprints for project 3"
• "Move issue 42 to in_review"
• "Add a task to issue 5: Write unit tests for the auth module"

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | DEVHUB_API_URL | No | https://devopshub.kiu.ac.ug | Base URL of your DEVHUB instance | | DEVHUB_API_TOKEN | Yes | — | API token from your Profile page |

Available Tools

Issues

| Tool | Description | |---|---| | list_issues | List/search issues with filters (status, priority, project, assignee, type) | | get_issue | Full issue details with comments, tasks, commits, and attachments | | my_issues | Issues assigned to you | | create_issue | Create a new issue (supports markdown, AI agent co-assignee) | | update_issue | Update fields: assignee, priority, type, description, sprint, AI agent | | update_issue_status | Change issue status with role-based rules | | add_comment | Add a comment (markdown supported) | | add_task | Add a checklist/task item to an issue | | upload_attachment | Upload a local file as an issue attachment | | download_attachment | Download an attachment to your local machine |

Sprints

| Tool | Description | |---|---| | list_sprints | List sprints, filter by project or status | | get_sprint | Sprint details with all issues listed | | create_sprint | Create a new sprint for a project | | start_sprint | Activate a planning sprint | | complete_sprint | Complete a sprint (moves incomplete issues to backlog) |

Other

| Tool | Description | |---|---| | list_projects | List all projects | | list_users | List/search users |

Access & Permissions

Your API token inherits your user role and organization unit scope:

• Admin — full access to all projects, issues, and users within your org units
• Developer — view/update issues assigned to you, create issues, add comments
• Reporter — create issues, add comments on your reported issues

Multiple Instances

You can connect to multiple DEVHUB instances by adding separate entries:

{
  "mcpServers": {
    "devhub-msl": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.campusmaster.cloud",
        "DEVHUB_API_TOKEN": "token-for-msl"
      }
    },
    "devhub-kiu": {
      "command": "npx",
      "args": ["-y", "@mblogik/devhub-mcp-server"],
      "env": {
        "DEVHUB_API_URL": "https://devopshub.kiu.ac.ug",
        "DEVHUB_API_TOKEN": "token-for-kiu"
      }
    }
  }
}

Development

To run from source (for contributing or debugging):

git clone https://github.com/uhahula/devhub.git
cd devhub/mcp-server
npm install
DEVHUB_API_TOKEN=your-token node index.js

The server communicates over stdio using the Model Context Protocol.

License

MIT