Devici MCP

🚀 Devici MCP Server

Devici APIとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、Deviciプラットフォームを通じて、ユーザー、コレクション、脅威モデル、コンポーネント、脅威、対策、チーム、およびダッシュボードデータを管理するLLMツールを提供します。

✨ 主な機能

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

📚 ドキュメント

設定

サーバーには3つの環境変数が必要です：

• 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準拠: モデルコンテキストプロトコルと完全に互換性がある

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. プルリクエストを開きます。

サポート

問題や質問については：

• Issuesページを確認してください。
• Devici APIドキュメントを確認してください。
• あなたのAPI資格情報が適切な権限を持っていることを確認してください。

注: これはDeviciの非公式MCPサーバーです。公式のDeviciサポートについては、Deviciチームにお問い合わせください。