mcp-servicenex

# servicenex-mcp-server A Model Context Protocol (MCP) server that provides AI assistants with secure access to ServiceNex knowledge base articles and support tickets. ## 🌟 Features - **MCP Tools**: Execute actions like fetching articles, searching, and retrieving tickets - **MCP Resources**: Access knowledge base data through structured resource URIs - **Real-time Data**: Connect directly to ServiceNex API for live data - **AI-Ready**: Formatted responses optimized for AI assistant consumption ## 🏗️ Architecture This server implements the Model Context Protocol (MCP), allowing AI assistants like Claude to: 1. **Discover** available tools and resources 2. **Invoke** tools to fetch ServiceNex data 3. **Access** resources via URIs ``` ┌─────────────┐ ┌──────────────────┐ ┌─────────────┐ │ AI Client │ ◄─MCP──►│ MCP Server │ ◄─API──►│ ServiceNex │ │ (Claude) │ │ (This Project) │ │ Platform │ └─────────────┘ └──────────────────┘ └─────────────┘ ``` ## 📦 Installation ### Option 1: Using uvx (Recommended) `uvx` allows you to run the MCP server without installing it globally. Install `uv` first: ```bash # Install uv (if not already installed) curl -LsSf https://astral.sh/uv/install.sh | sh # Run the MCP server directly with uvx uvx mcp-servicenex ``` No installation needed! `uvx` will automatically download and run the package when published. ### Option 2: Install from PyPI Alternatively, you can install the package globally: ```bash pip install mcp-servicenex ``` Or using `uv`: ```bash uv pip install mcp-servicenex ``` ### Option 3: Install from Source 1. **Clone the repository**: ```bash git clone <repository-url> cd servicenex-mcp-server ``` 2. **Create and activate virtual environment**: ```bash python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate ``` > **Note**: If you encounter an error about `ensurepip` not being available (common on Debian/Ubuntu)…