Sde MCP

🚀 SD Elements MCP 服務器

SD Elements MCP 服務器是一個模型上下文協議（MCP）服務器，提供 SD Elements API 集成。該服務器使大語言模型（LLMs）能夠與 SD Elements 安全開發生命週期平臺進行交互。

🚀 快速開始

使用 uvx（推薦）

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

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

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

uvx sde-mcp-server

使用 uv

從 GitHub 安裝

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

從 PyPI 安裝（可用時）

uv pip install sde-mcp-server
sde-mcp-server

使用 pip

從 GitHub 安裝

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

從 PyPI 安裝（可用時）

pip install sde-mcp-server
sde-mcp-server

✨ 主要特性

• 完整的 API 覆蓋：支持所有主要的 SD Elements API 端點。
• 身份驗證：基於安全 API 密鑰的身份驗證。
• 錯誤處理：全面的錯誤處理和驗證。
• 環境配置：通過環境變量進行靈活配置。
• 現代 Python 構建：使用現代 Python 打包工具（uv、pyproject.toml）構建。
• MCP 兼容：完全符合模型上下文協議。

📦 安裝指南

配置環境變量

服務器需要兩個環境變量：

• SDE_HOST：你的 SD Elements 實例 URL（例如，https://your-sdelements-instance.com）
• SDE_API_KEY：你的 SD Elements API 密鑰

選項 1：設置環境變量

export SDE_HOST="https://your-sdelements-instance.com"
export SDE_API_KEY="your-api-key-here"

選項 2：使用 .env 文件

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

SDE_HOST=https://your-sdelements-instance.com
SDE_API_KEY=your-api-key-here

獲取 API 密鑰

1. 登錄到你的 SD Elements 實例。
2. 轉到 設置 > API 令牌。
3. 生成一個新的 API 令牌。
4. 複製令牌值，用作 SDE_API_KEY。

💻 使用示例

可用工具

項目管理

• list_projects - 列出所有項目，可選擇過濾條件
• get_project - 獲取項目詳細信息
• create_project - 創建新項目
• update_project - 更新項目詳細信息
• delete_project - 刪除項目

應用程序管理

• list_applications - 列出所有應用程序
• get_application - 獲取應用程序詳細信息
• create_application - 創建新應用程序
• update_application - 更新應用程序信息

對策管理

• list_countermeasures - 列出項目的對策
• get_countermeasure - 獲取對策詳細信息
• update_countermeasure - 更新對策狀態

任務與調查

• list_tasks - 列出項目的任務
• get_task - 獲取任務詳細信息
• list_surveys - 列出調查
• get_survey - 獲取調查詳細信息

階段與里程碑

• list_phases - 列出項目階段
• get_phase - 獲取階段詳細信息
• list_milestones - 列出項目里程碑

📚 詳細文檔

MCP 客戶端配置

Claude Desktop

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

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

{
  "mcpServers": {
    "sde-elements": {
      "command": "uvx",
      "args": ["git+https://github.com/geoffwhittington/sde-mcp.git"],
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

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

{
  "mcpServers": {
    "sde-elements": {
      "command": "uvx",
      "args": ["sde-mcp-server"],
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline

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

從 GitHub 安裝（當前可用）

{
  "mcpServers": {
    "sde-elements": {
      "command": "uvx",
      "args": ["git+https://github.com/geoffwhittington/sde-mcp.git"],
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Continue

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

從 GitHub 安裝（當前可用）

{
  "mcpServers": {
    "sde-elements": {
      "command": "uvx",
      "args": ["git+https://github.com/geoffwhittington/sde-mcp.git"],
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

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

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

{
  "mcpServers": {
    "sde-elements": {
      "command": "uvx",
      "args": ["git+https://github.com/geoffwhittington/sde-mcp.git"],
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

選項 2：使用本地安裝

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

{
  "mcpServers": {
    "sde-elements": {
      "command": "sde-mcp-server",
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

選項 3：直接使用 Python 模塊

{
  "mcpServers": {
    "sde-elements": {
      "command": "python",
      "args": ["-m", "sde_mcp_server"],
      "env": {
        "SDE_HOST": "https://your-sdelements-instance.com",
        "SDE_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔧 技術細節

開發

前提條件

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

環境搭建

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

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

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

測試

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

# 使用環境變量進行測試
SDE_HOST=https://demo.sdelements.com SDE_API_KEY=test uv run python -m sde_mcp_server

構建

# 構建軟件包
uv build

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

API 覆蓋範圍

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

• 項目和應用程序
• 對策和任務
• 調查和階段
• 里程碑和需求
• 用戶和團隊
• 合規性和報告

📄 許可證

本項目採用 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. 打開拉取請求。

支持

對於問題和疑問：

1. 查看 問題 頁面。
2. 查看 SD Elements API 文檔。
3. 確保你的 API 密鑰具有適當的權限。

⚠️ 重要提示

這是一個非官方的 SD Elements MCP 服務器。如需官方 SD Elements 支持，請聯繫 Security Compass。