Home - sieteunoseis/mcp-cisco-support GitHub Wiki
๐ Cisco Support MCP Server Wiki
Welcome to the comprehensive documentation hub for the Cisco Support MCP Server - a production-ready TypeScript MCP (Model Context Protocol) server providing access to multiple Cisco Support APIs.
๐ Quick Start
New to the project? Start here:
- Quick Installation Guide - Get up and running in minutes
- Available Tools - See all 33 MCP tools across 6 Cisco APIs
- Advanced Configuration - Environment variables and deployment options
๐ Project Status
โ 6/8 Cisco APIs Implemented (75%)
- 33 Total Tools across Bug, Case, EoX, PSIRT, Product, and Software APIs
- Production Ready with comprehensive security and testing
- Multi-Transport Support - stdio (Claude Desktop) and HTTP (remote server)
๐ ๏ธ Core Documentation
๐ง Setup & Configuration
- Advanced Configuration - Environment variables, Claude Desktop integration, API configurations
- Security Guide - Authentication, Bearer tokens, security best practices
- Docker Deployment - Containerized deployment with production configurations
๐ API & Tools
- Available Tools - Complete reference for all 33 MCP tools with JSON-RPC examples
- MCP Prompts - 5 specialized prompts for guided Cisco support workflows
- SSE Integration - Server-Sent Events and real-time communication
๐งช Development & Testing
- Development Guide - Architecture, contributing, adding new APIs
- Testing Framework - Jest-based testing with mocks and integration tests
- Troubleshooting Guide - Common issues, debugging, and solutions
๐ฏ Use Cases
๐จโ๐ป Support Engineers
- Search and analyze Cisco bugs across products
- Investigate security vulnerabilities (PSIRT)
- Plan software upgrades and maintenance
- Track product lifecycle and end-of-life notifications
๐ข Network Administrators
- Monitor product security advisories
- Plan hardware refresh cycles
- Validate software compatibility
- Research known issues before deployments
๐ฌ Developers & Integrators
- Integrate Cisco Support APIs into workflows
- Build custom automation with MCP tools
- Access real-time support data via SSE
- Extend server with additional APIs
๐ Key Features
- ๐ Secure Authentication - OAuth2 with Cisco APIs, Bearer token protection for HTTP
- โก Real-time Updates - Server-Sent Events for live data streaming
- ๐งช Comprehensive Testing - 38+ passing tests with full coverage
- ๐ณ Container Ready - Docker deployment with health checks
- ๐ฑ Multi-Platform - Works with Claude Desktop, MCP Inspector, N8N, and custom clients
- ๐ Auto-refresh - Automatic token management and error recovery
๐ API Implementation Status
| API | Status | Tools | Description |
|---|---|---|---|
| Bug | โ Complete | 8 tools | Bug search, details, product-specific queries |
| Case | โ Complete | 4 tools | Support case management and operations |
| EoX | โ Complete | 4 tools | End-of-Life/Sale information and lifecycle planning |
| PSIRT | โ Complete | 8 tools | Security vulnerability data and advisories |
| Product | โ Complete | 3 tools | Product details and specifications |
| Software | โ Complete | 6 tools | Software suggestions and upgrade recommendations |
| Serial | ๐ Planned | 0 tools | Serial number to product mapping |
| RMA | ๐ Planned | 0 tools | Return Merchandise Authorization |
๐จ Need Help?
- Issues? Check the Troubleshooting Guide
- Questions? Review the FAQ sections in our guides
- Bugs? Report at GitHub Issues
- Feature Requests? See our Development Roadmap
๐ค Contributing
Want to contribute? Check out our Development Guide for:
- Project architecture and patterns
- Adding new Cisco APIs
- Testing procedures
- Code contribution guidelines
๐ This wiki contains over 3,000 lines of documentation covering everything from basic setup to advanced development. Use the navigation above to find exactly what you need!
Last updated: $(date '+%Y-%m-%d')