星战科技xingzhan.cloud
返回市场
设备-MCP

设备-MCP

作者：geoffwhittington3 星标更新：2025-07-04
安装使用来源：spider==github.com

项目介绍

Devici MCP Server

这是一个用于与Devici API交互的Model Context Protocol (MCP)服务器。该服务器通过Devici平台提供了管理用户、集合、威胁模型、组件、威胁、缓解措施、团队以及仪表板数据的LLM工具。

License: MIT Python 3.10+ uv

功能

Devici MCP Server 提供了以下工具：

用户管理

  • 分页获取用户
  • 根据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-m

从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覆盖：支持所有主要的Devici API端点
  • 认证：基于客户端ID/密钥的安全认证
  • 错误处理：全面的错误处理和验证
  • 环境配置：通过环境变量灵活配置
  • 现代Python：使用现代Python打包（uv, pyproject.toml）构建
  • MCP兼容：完全符合Model Context Protocol

API覆盖

此服务器提供对以下内容的访问：

  • 用户和团队
  • 集合和威胁模型
  • 组件和威胁
  • 缓解措施和评论
  • 仪表板数据和报告
  • 审计日志和Codex集成
  • 搜索和批量操作

许可证

本项目根据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团队。