Devici MCP

🚀 Devici MCP 服務器

Devici MCP 服務器是一個用於與 Devici API 交互的模型上下文協議（MCP）服務器。該服務器通過 Devici 平臺提供大語言模型（LLM）工具，用於管理用戶、集合、威脅模型、組件、威脅、緩解措施、團隊和儀表盤數據。

✨ 主要特性

用戶管理

• 支持分頁獲取用戶列表
• 通過 ID 獲取特定用戶信息
• 根據字段和文本搜索用戶
• 邀請新用戶

集合管理

• 支持分頁獲取集合列表
• 通過 ID 獲取特定集合信息
• 創建新的集合

威脅模型管理

• 支持分頁獲取所有威脅模型
• 根據集合獲取威脅模型
• 通過 ID 獲取特定威脅模型信息
• 創建新的威脅模型

組件管理

• 支持分頁獲取組件列表
• 通過 ID 獲取特定組件信息
• 根據畫布獲取組件
• 創建新的組件

威脅管理

• 支持分頁獲取威脅列表
• 通過 ID 獲取特定威脅信息
• 根據組件獲取威脅
• 創建新的威脅

緩解措施管理

• 支持分頁獲取緩解措施列表
• 通過 ID 獲取特定緩解措施信息
• 根據威脅獲取緩解措施
• 創建新的緩解措施

團隊管理

• 支持分頁獲取團隊列表
• 通過 ID 獲取特定團隊信息
• 獲取團隊成員列表
• 創建新的團隊

儀表盤與報告

• 獲取儀表盤數據
• 獲取報告數據
• 獲取威脅模型統計信息

評論與審計

• 支持分頁獲取評論列表
• 通過 ID 獲取特定評論信息
• 獲取審計日誌

Codex 集成

• 獲取 Codex 屬性
• 獲取 Codex 緩解措施
• 獲取 Codex 威脅

🚀 快速開始

使用 uvx（推薦）

選項 1：從 GitHub 安裝（當前可用）

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

選項 2：從 PyPI 安裝（未來發布後可用）

uvx devici-mcp-server

使用 uv

從 GitHub 安裝

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

從 PyPI 安裝（可用時）

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

使用 pip

從 GitHub 安裝

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

從 PyPI 安裝（可用時）

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

📦 安裝指南

配置環境變量

服務器需要以下三個環境變量：

• DEVICI_API_BASE_URL：你的 Devici 實例 URL（例如：https://api.devici.com/v1）
• DEVICI_CLIENT_ID：你的 Devici 客戶端 ID
• DEVICI_CLIENT_SECRET：你的 Devici 客戶端密鑰

選項 1：設置環境變量

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"

選項 2：使用 .env 文件

在工作目錄中創建一個 .env 文件：

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

獲取 API 憑證

1. 登錄到你的 Devici 實例。
2. 轉到 設置 > API 訪問。
3. 生成新的客戶端 ID 和密鑰。
4. 複製這些值，用作 DEVICI_CLIENT_ID 和 DEVICI_CLIENT_SECRET。

MCP 客戶端配置

Claude Desktop

將以下內容添加到你的 Claude Desktop 配置文件中：

選項 1：從 GitHub 安裝（當前可用）

{
  "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"
      }
    }
  }
}

選項 2：從 PyPI 安裝（未來可用）

{
  "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

將以下內容添加到你的 Cline MCP 設置中：

從 GitHub 安裝（當前可用）

{
  "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

將以下內容添加到你的 Continue 配置中：

從 GitHub 安裝（當前可用）

{
  "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

將以下內容添加到你的 Cursor 配置文件中：

選項 1：從 GitHub 安裝（當前可用）

{
  "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"
      }
    }
  }
}

選項 2：使用本地安裝

如果你已經在本地安裝了該包：

{
  "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"
      }
    }
  }
}

選項 3：直接使用 Python 模塊

{
  "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"
      }
    }
  }
}

🔧 開發

前提條件

• 安裝 uv
• Python 3.10 或更高版本

環境搭建

# 克隆倉庫
git clone <repository-url>
cd devici-mcp

# 創建虛擬環境並安裝依賴
uv sync

# 以開發模式運行
uv run python -m devici_mcp_server

測試

# 運行導入測試
uv run python test_basic.py

# 使用環境變量進行測試
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

打包

# 打包項目
uv build

# 本地安裝以進行測試
uv pip install dist/*.whl

📚 詳細文檔

API 覆蓋範圍

該服務器提供對以下內容的訪問：

• 用戶和團隊
• 集合和威脅模型
• 組件和威脅
• 緩解措施和評論
• 儀表盤數據和報告
• 審計日誌和 Codex 集成
• 搜索和批量操作

特性總結

• 全面的 API 覆蓋：支持所有主要的 Devici API 端點
• 認證機制：基於客戶端 ID/密鑰的安全認證
• 錯誤處理：全面的錯誤處理和驗證機制
• 環境配置：通過環境變量實現靈活的配置
• 現代 Python 技術棧：採用現代 Python 打包工具（uv, pyproject.toml）構建
• MCP 兼容：完全符合模型上下文協議

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

貢獻指南

1. 分叉倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送至分支 (git push origin feature/amazing-feature)
5. 發起拉取請求

支持

如果遇到問題或有疑問：

• 查看 問題 頁面
• 查閱 Devici API 文檔
• 確保你的 API 憑證具有適當的權限

⚠️ 重要提示

這是一個非官方的 Devici MCP 服務器。如需官方 Devici 支持，請聯繫 Devici 團隊。