Skip to main content
Glama

Devici MCP Server

by geoffwhittington
GitHub
Python
MIT License
3
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Devici MCP Server

A Model Context Protocol (MCP) server for interacting with the Devici API. This server provides LLM tools to manage users, collections, threat models, components, threats, mitigations, teams, and dashboard data through the Devici platform.

License: MIT Python 3.10+ uv

Features

The Devici MCP Server provides tools for:

User Management

  • Get users with pagination

  • Get specific user by ID

  • Search users by field and text

  • Invite new users

Collections Management

  • Get collections with pagination

  • Get specific collection by ID

  • Create new collections

Threat Models Management

  • Get all threat models with pagination

  • Get threat models by collection

  • Get specific threat model by ID

  • Create new threat models

Components Management

  • Get components with pagination

  • Get specific component by ID

  • Get components by canvas

  • Create new components

Threats Management

  • Get threats with pagination

  • Get specific threat by ID

  • Get threats by component

  • Create new threats

Mitigations Management

  • Get mitigations with pagination

  • Get specific mitigation by ID

  • Get mitigations by threat

  • Create new mitigations

Teams Management

  • Get teams with pagination

  • Get specific team by ID

  • Get team users

  • Create new teams

Dashboard & Reports

  • Get dashboard data

  • Get report data

  • Get threat model statistics

Comments & Audit

  • Get comments with pagination

  • Get specific comment by ID

  • Get audit logs

Codex Integration

  • Get codex attributes

  • Get codex mitigations

  • Get codex threats

Quick Start

Using uvx (recommended)

Option 1: From GitHub (Current)

uvx git+https://github.com/geoffwhittington/devici-mcp.git

Option 2: From PyPI (Future - when published)

uvx devici-mcp-server

Using uv

Install from GitHub

uv pip install git+https://github.com/geoffwhittington/devici-mcp.git devici-mcp-server

Install from PyPI (when available)

uv pip install devici-mcp-server devici-mcp-server

Using pip

Install from GitHub

pip install git+https://github.com/geoffwhittington/devici-mcp.git devici-mcp-server

Install from PyPI (when available)

pip install devici-mcp-server devici-mcp-server

Configuration

The server requires three environment variables:

  • DEVICI_API_BASE_URL: Your Devici instance URL (e.g., https://api.devici.com/v1)

  • DEVICI_CLIENT_ID: Your Devici client ID

  • DEVICI_CLIENT_SECRET: Your Devici client secret

Setting Environment Variables

Option 1: Environment Variables

export DEVICI_API_BASE_URL="https://api.devici.com/v1" export DEVICI_CLIENT_ID="your-client-id-here" export DEVICI_CLIENT_SECRET="your-client-secret-here"

Option 2: .env File

Create a .env file in your working directory:

DEVICI_API_BASE_URL=https://api.devici.com/v1 DEVICI_CLIENT_ID=your-client-id-here DEVICI_CLIENT_SECRET=your-client-secret-here

Getting Your API Credentials

  1. Log into your Devici instance

  2. Go to Settings > API Access

  3. Generate a new client ID and secret

  4. Copy the values for use as DEVICI_CLIENT_ID and DEVICI_CLIENT_SECRET

MCP Client Configuration

Claude Desktop

Add this to your Claude Desktop configuration file:

Option 1: From GitHub (Current)

{ "mcpServers": { "devici": { "command": "uvx", "args": ["git+https://github.com/geoffwhittington/devici-mcp.git"], "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Option 2: From PyPI (Future)

{ "mcpServers": { "devici": { "command": "uvx", "args": ["devici-mcp-server"], "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Cline

Add this to your Cline MCP settings:

From GitHub (Current)

{ "mcpServers": { "devici": { "command": "uvx", "args": ["git+https://github.com/geoffwhittington/devici-mcp.git"], "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Continue

Add this to your Continue configuration:

From GitHub (Current)

{ "mcpServers": { "devici": { "command": "uvx", "args": ["git+https://github.com/geoffwhittington/devici-mcp.git"], "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/api/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Cursor

Add this to your Cursor configuration file:

Option 1: From GitHub (Current)

{ "mcpServers": { "devici": { "command": "uvx", "args": ["git+https://github.com/geoffwhittington/devici-mcp.git"], "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/api/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Option 2: Using local installation

If you have the package installed locally:

{ "mcpServers": { "devici": { "command": "devici-mcp-server", "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/api/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Option 3: Using Python module directly

{ "mcpServers": { "devici": { "command": "python", "args": ["-m", "devici_mcp_server"], "env": { "DEVICI_API_BASE_URL": "https://api.devici.com/api/v1", "DEVICI_CLIENT_ID": "your-client-id-here", "DEVICI_CLIENT_SECRET": "your-client-secret-here" } } } }

Development

Prerequisites

  • uv installed

  • Python 3.10 or higher

Setup

# Clone the repository git clone <repository-url> cd devici-mcp # Create virtual environment and install dependencies uv sync # Run in development mode uv run python -m devici_mcp_server

Testing

# Run the import test uv run python test_basic.py # Test with environment variables DEVICI_API_BASE_URL=https://api.devici.com/api/v1 DEVICI_CLIENT_ID=test DEVICI_CLIENT_SECRET=test uv run python -m devici_mcp_server

Building

# Build the package uv build # Install locally for testing uv pip install dist/*.whl

Features

  • Full API Coverage: Supports all major Devici API endpoints

  • Authentication: Secure client ID/secret-based authentication

  • Error Handling: Comprehensive error handling and validation

  • Environment Configuration: Flexible configuration via environment variables

  • Modern Python: Built with modern Python packaging (uv, pyproject.toml)

  • MCP Compliant: Fully compatible with the Model Context Protocol

API Coverage

This server provides access to:

  • Users and Teams

  • Collections and Threat Models

  • Components and Threats

  • Mitigations and Comments

  • Dashboard Data and Reports

  • Audit Logs and Codex Integration

  • Search and Bulk Operations

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

Support

For issues and questions:

  • Check the Issues page

  • Review the Devici API documentation

  • Ensure your API credentials have proper permissions

Note: This is an unofficial MCP server for Devici. For official Devici support, please contact the Devici team.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Provides LLM tools to interact with the Devici API, enabling management of threat modeling resources including users, collections, threat models, components, threats, mitigations, and teams.

  1. Features
    1. User Management
    2. Collections Management
    3. Threat Models Management
    4. Components Management
    5. Threats Management
    6. Mitigations Management
    7. Teams Management
    8. Dashboard & Reports
    9. Comments & Audit
    10. Codex Integration
  2. Quick Start
    1. Using uvx (recommended)
    2. Using uv
    3. Using pip
  3. Configuration
    1. Setting Environment Variables
    2. Getting Your API Credentials
  4. MCP Client Configuration
    1. Claude Desktop
    2. Cline
    3. Continue
    4. Cursor
  5. Development
    1. Prerequisites
    2. Setup
    3. Testing
    4. Building
  6. Features
    1. API Coverage
      1. License
        1. Contributing
          1. Support

            Related Resources

            Related MCP Servers

            • MCP Tavily Search Server

              spences10
              A
              security
              A
              license
              A
              quality
              Integrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.
              Last updated -
              28
              8
              MIT License
              • Linux

            • Model Context Provider (MCP) Server

              Mark850409
              -
              security
              F
              license
              -
              quality
              Facilitates enhanced interaction with large language models (LLMs) by providing intelligent context management, tool integration, and multi-provider AI model coordination for efficient AI-driven workflows.
              Last updated -

            • Linear MCP Server

              gerbal
              -
              security
              F
              license
              -
              quality
              Allows LLMs to integrate with Linear's issue tracking system, enabling them to create, update, search, and comment on issues through the Linear API.
              Last updated -
              236

            • LLM Bridge MCP

              sjquant
              A
              security
              A
              license
              A
              quality
              Enables AI agents to interact with multiple LLM providers (OpenAI, Anthropic, Google, DeepSeek) through a standardized interface, making it easy to switch between models or use multiple models in the same application.
              Last updated -
              1
              5
              MIT License
              • Linux
              • Apple

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/geoffwhittington/devici-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server