MCP Cisco Support

🚀 思科支持MCP服務器

這是一個生產就緒的TypeScript MCP（模型上下文協議）服務器，專為思科支持API設計，具備全面的安全性和雙傳輸支持。該可擴展服務器可訪問多個思科支持API，包括漏洞搜索、案例管理和產品生命週期結束信息等。

🚀 快速開始

NPX安裝（推薦）

在Claude桌面客戶端中以標準輸入輸出模式啟動：

npx mcp-cisco-support

啟動帶有身份驗證的HTTP服務器：

npx mcp-cisco-support --http
# 控制檯將顯示用於身份驗證的令牌

為HTTP模式生成Bearer令牌：

npx mcp-cisco-support --generate-token

獲取幫助並查看所有選項：

npx mcp-cisco-support --help

環境設置

1. 生成身份驗證令牌（用於HTTP模式）：

   npx mcp-cisco-support --generate-token
   export MCP_BEARER_TOKEN=<生成的令牌>
   

2. 設置思科API憑證：

   export CISCO_CLIENT_ID=你的客戶端ID
   export CISCO_CLIENT_SECRET=你的客戶端密鑰
   export SUPPORT_API=bug,case,eox,psirt,product,software  # 所有已實現的API（推薦）
   

3. 啟動服務器：

   # 用於Claude桌面客戶端（標準輸入輸出模式）
   npx mcp-cisco-support
   
   # 用於HTTP訪問（帶有身份驗證）
   npx mcp-cisco-support --http
   

本地開發

git clone https://github.com/sieteunoseis/mcp-cisco-support.git
cd mcp-cisco-support
npm install
npm run build
npm start

✨ 主要特性

• 多API支持：全面實現了6個思科支持API（共33個工具）
• Bearer令牌認證：為HTTP端點提供MCP檢查器風格的安全保障
• 可配置的API訪問：僅啟用你有權限訪問的思科支持API
• 專業提示：提供9個工作流提示，用於指導思科支持場景
• 雙傳輸模式：標準輸入輸出（本地MCP客戶端）和HTTP（帶有身份驗證的遠程服務器）
• OAuth2認證：與思科API實現自動令牌管理
• 實時更新：HTTP模式下支持服務器發送事件
• TypeScript：具備完整的類型安全性，並集成了MCP SDK
• 生產安全：採用Helmet、CORS、輸入驗證和Bearer令牌等安全措施
• Docker支持：支持容器化部署，並具備健康檢查功能
• 全面日誌記錄：採用帶時間戳的結構化日誌記錄

📦 支持的思科API

服務器支持以下思科支持API（可通過SUPPORT_API環境變量進行配置）：

實現狀態：8個API中已完成6個（75%），共33個工具

配置示例：

• SUPPORT_API=enhanced_analysis - 僅啟用增強分析工具（6個工具） ← 大多數用戶推薦
• SUPPORT_API=bug - 啟用所有漏洞API工具，包括增強分析（14個工具）
• SUPPORT_API=bug,case,eox,psirt - 核心支持API（28個工具）
• SUPPORT_API=bug,case,eox,psirt,product,software - 所有已實現的API（39個工具）
• SUPPORT_API=all - 所有可用的API（包括2個佔位API）

💻 使用示例

基礎用法

# 測試服務器連接性
curl http://localhost:3000/ping

# 檢查健康狀態
curl http://localhost:3000/health

# 列出可用工具（主MCP端點）
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list"
  }'

# 列出可用工具（適用於N8N的替代端點）
curl -X POST http://localhost:3000/messages \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list"
  }'

# 測試SSE連接（將顯示端點事件）
curl -N http://localhost:3000/sse

# 按關鍵字搜索漏洞
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "tools/call",
    "params": {
      "name": "search_bugs_by_keyword",
      "arguments": {
        "keyword": "crash",
        "severity": "1",
        "status": "open"
      }
    }
  }'

# 獲取特定漏洞詳情
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "3",
    "method": "tools/call",
    "params": {
      "name": "get_bug_details",
      "arguments": {
        "bug_ids": "CSCab12345"
      }
    }
  }'

高級用法

async function searchBugs(keyword) {
  const response = await fetch('http://localhost:3000/mcp', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: Date.now(),
      method: 'tools/call',
      params: {
        name: 'search_bugs_by_keyword',
        arguments: {
          keyword: keyword,
          page_index: 1,
          status: 'open'
        }
      }
    })
  });
  
  const result = await response.json();
  return result;
}

📚 詳細文檔

如需詳細信息，請參閱我們全面的GitHub Wiki：

• 📋 可用工具 - 涵蓋6個API的所有33個MCP工具的完整參考
• 🔧 高級配置 - 環境變量和部署選項
• 🔒 安全指南 - 身份驗證、令牌和安全最佳實踐
• 🚀 Docker部署 - 容器化部署和生產設置
• 🌐 SSE集成 - 服務器發送事件和實時通信
• 🧪 測試框架 - 全面的測試和驗證
• 🔧 開發指南 - 貢獻、架構和API開發
• 🚨 故障排除指南 - 常見問題和調試
• ⚡ MCP提示 - 用於思科支持場景的指導工作流

🔧 技術細節

健康監控

服務器提供了一個全面的健康檢查端點：

curl http://localhost:3000/health

響應內容包括：

• 服務器狀態
• OAuth2令牌狀態
• 內存使用情況
• 運行時間
• 活躍的SSE連接

安全特性

• Helmet：設置安全頭信息
• CORS：支持跨域資源共享
• 輸入驗證：基於模式的輸入驗證
• 非根執行：保障Docker安全
• 環境變量：安全存儲憑證

測試

運行測試

# 運行所有測試
npm test

# 以監視模式運行測試
npm run test:watch

# 運行帶覆蓋率的測試
npm run test:coverage

# 運行特定測試套件
npx jest tests/auth.test.js
npx jest tests/mcp-tools.test.js

測試結構

測試套件包括：

• 身份驗證測試 (tests/auth.test.js)：OAuth2身份驗證、令牌管理和錯誤處理
• MCP工具測試 (tests/mcp-tools.test.js)：所有8個MCP工具、錯誤處理和分頁
• 設置 (tests/setup.js)：測試環境配置

性能考慮

• 令牌緩存可減少API調用次數
• 分頁將結果限制為每頁10條
• SSE每30秒發送一次心跳以保持連接活躍
• 請求超時設置為30秒

安全注意事項

• 切勿將.env文件提交到版本控制中
• 使用環境變量存儲所有機密信息
• 審查思科API的使用限制和條款
• 監控日誌以發現可疑活動

📄 許可證

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