summitai-mcp 0.1.0__tar.gz

summitai_mcp-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+.venv/
+venv/
+ENV/
+env/
+.env
+.env.*
+!.env.example
+*.log
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+.idea/
+.vscode/
+*.swp
+*.swo
+*.DS_Store
+Thumbs.db

summitai_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to `summitai-mcp` will be documented in this file.
+
+## [0.1.0] — 2026-09-03
+
+### Added
+- Initial release
+- **Incident Management**: create, update (all statuses), get, list
+- **Service Request**: create, update, get, list, get catalog, approve, get by user
+- **CMDB**: create/update CI, get CI, link relations, get master data
+- **Problem Management**: create/update, get problem record
+- **Change Management**: create/update, get change record
+- **Work Orders**: create (for IM and SR), get details
+- **Attachments**: upload via base64
+- **Users**: search, create/update user master
+- Dual auth: APIKEY (recommended) and Username/Password (legacy)
+- stdio transport for Claude Desktop, Cursor, and Antigravity compatibility
+- Full env-var configuration (SUMMITAI_BASE_URL, SUMMITAI_API_KEY, etc.)

summitai_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Symphony Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

summitai_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.5
+Name: summitai-mcp
+Version: 0.1.0
+Summary: MCP server for SymphonyAI SummitAI/Apex ITSM platform — Incident, Service Request, CMDB, Problem, Change, Work Order, Attachments, and User management
+Project-URL: Homepage, https://github.com/your-org/summitai-mcp
+Project-URL: Documentation, https://github.com/your-org/summitai-mcp#readme
+Project-URL: Bug Tracker, https://github.com/your-org/summitai-mcp/issues
+Author: Symphony Team
+License: MIT
+License-File: LICENSE
+Keywords: apex,cmdb,incident-management,itsm,mcp,service-request,summitai,symphonyai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# summitai-mcp
+
+**MCP Server for SymphonyAI SummitAI/Apex ITSM**
+
+Connect any MCP-compatible AI assistant (Claude, Cursor, Antigravity, etc.) directly to your SymphonyAI SummitAI instance. Create tickets, search records, manage CIs, approve requests — all through natural language.
+
+---
+
+## Quick Start
+
+### Option 1: Run directly with uvx (no install needed)
+```json
+{
+  "mcpServers": {
+    "summitai": {
+      "command": "uvx",
+      "args": ["summitai-mcp"],
+      "env": {
+        "SUMMITAI_BASE_URL": "https://your-instance.symphonysummit.com",
+        "SUMMITAI_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Install then run
+```bash
+pip install summitai-mcp
+summitai-mcp
+```
+
+---
+
+## Configuration (Environment Variables)
+
+| Variable | Required | Description |
+|---|---|---|
+| `SUMMITAI_BASE_URL` | ✅ Yes | Your SummitAI instance URL, e.g. `https://yourcompany.symphonysummit.com` |
+| `SUMMITAI_API_KEY` | ✅ Recommended | API key from **Admin → Users → [your user] → Access tab → Login Type = API Key** |
+| `SUMMITAI_USERNAME` | Alt | Username — use if API key not available |
+| `SUMMITAI_PASSWORD` | Alt | Password — paired with USERNAME |
+| `SUMMITAI_ORG_ID` | No | Tenant/Org ID (default: `1`) |
+| `SUMMITAI_PROXY_ID` | No | Proxy ID (default: `0`) |
+| `SUMMITAI_LOG_LEVEL` | No | `DEBUG`, `INFO`, `WARNING` (default: `WARNING`) |
+
+> **Note**: Set `SUMMITAI_API_KEY` **or** both `SUMMITAI_USERNAME` + `SUMMITAI_PASSWORD`. API Key is the recommended auth method since SummitAI Sierra HF01+.
+
+---
+
+## Tools Reference
+
+### 🔴 Incident Management
+| Tool | Description |
+|---|---|
+| `create_incident` | Log a new Incident (New status) |
+| `update_incident` | Update status, assign, resolve, or close an Incident |
+| `get_incident` | Get full Incident details + change history |
+| `list_incidents` | Search/filter Incidents by status, workgroup, date range |
+
+### 🟡 Service Request
+| Tool | Description |
+|---|---|
+| `create_service_request` | Create SR from a Service Catalog item |
+| `update_service_request` | Update SR status, assignment, or remarks |
+| `get_service_request` | Get SR details + change history |
+| `list_service_requests` | Search/filter SRs |
+| `get_service_catalog` | Get catalog item details and custom fields |
+| `approve_service_request` | Approve or reject an SR |
+| `get_my_service_requests` | Get all SRs for a specific user |
+
+### 🟢 CMDB
+| Tool | Description |
+|---|---|
+| `create_or_update_ci` | Create or update a Configuration Item |
+| `get_ci` | Search and retrieve CI details |
+| `link_ci_relation` | Create relationships between CIs |
+| `get_cmdb_masters` | Get CI types, statuses, locations lookup data |
+
+### 🟠 Problem Management
+| Tool | Description |
+|---|---|
+| `create_or_update_problem` | Create or update a Problem Record |
+| `get_problem` | Get Problem Record details |
+
+### 🔵 Change Management
+| Tool | Description |
+|---|---|
+| `create_or_update_change` | Create or update a Change Record |
+| `get_change_record` | Get Change Record details |
+
+### ⚙️ Work Orders
+| Tool | Description |
+|---|---|
+| `create_work_order` | Create a Work Order for an IM or SR ticket |
+| `get_work_order` | Get Work Order details |
+
+### 📎 Attachments
+| Tool | Description |
+|---|---|
+| `upload_attachment` | Attach a file (base64) to any ITSM record |
+
+### 👤 Users & Admin
+| Tool | Description |
+|---|---|
+| `search_users` | Search users by email, employee ID, or name |
+| `create_or_update_user` | Create or update a user account |
+
+---
+
+## Setup for Claude Desktop
+
+Edit `%APPDATA%\Claude\claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "summitai": {
+      "command": "uvx",
+      "args": ["summitai-mcp"],
+      "env": {
+        "SUMMITAI_BASE_URL": "https://your-instance.symphonysummit.com",
+        "SUMMITAI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Setup for Antigravity (AGY)
+
+Edit your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "summitai": {
+      "command": "uvx",
+      "args": ["summitai-mcp"],
+      "env": {
+        "SUMMITAI_BASE_URL": "https://your-instance.symphonysummit.com",
+        "SUMMITAI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+---
+
+## How to Get Your API Key
+
+1. Log into your SummitAI/Apex instance as Admin
+2. Go to **Admin → Basic → Users**
+3. Find your user → click **Access** tab
+4. Set **Login Type** to **API Key**
+5. Copy the generated key
+
+---
+
+## API Reference
+
+All tools connect to the single SummitAI REST endpoint:
+```
+POST {SUMMITAI_BASE_URL}/REST/Summit_RESTWCF.svc/RESTService/CommonWS_JsonObjCall
+```
+
+Each tool sets the `ServiceName` field to route to the correct operation. Authentication is injected automatically from your environment variables.
+
+---
+
+## Development
+
+```bash
+# Clone and install dev dependencies
+git clone https://github.com/your-org/summitai-mcp
+cd summitai-mcp
+uv sync
+
+# Test with MCP Inspector (visual tool tester)
+uv run mcp dev src/summitai_mcp/server.py
+
+# Run tests
+uv run pytest tests/
+```
+
+---
+
+## Publishing to PyPI
+
+```bash
+uv build
+uvx twine upload dist/*
+```
+
+---
+
+## License
+
+MIT

summitai_mcp-0.1.0/README.md

@@ -0,0 +1,200 @@
+# summitai-mcp
+
+**MCP Server for SymphonyAI SummitAI/Apex ITSM**
+
+Connect any MCP-compatible AI assistant (Claude, Cursor, Antigravity, etc.) directly to your SymphonyAI SummitAI instance. Create tickets, search records, manage CIs, approve requests — all through natural language.
+
+---
+
+## Quick Start
+
+### Option 1: Run directly with uvx (no install needed)
+```json
+{
+  "mcpServers": {
+    "summitai": {
+      "command": "uvx",
+      "args": ["summitai-mcp"],
+      "env": {
+        "SUMMITAI_BASE_URL": "https://your-instance.symphonysummit.com",
+        "SUMMITAI_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Install then run
+```bash
+pip install summitai-mcp
+summitai-mcp
+```
+
+---
+
+## Configuration (Environment Variables)
+
+| Variable | Required | Description |
+|---|---|---|
+| `SUMMITAI_BASE_URL` | ✅ Yes | Your SummitAI instance URL, e.g. `https://yourcompany.symphonysummit.com` |
+| `SUMMITAI_API_KEY` | ✅ Recommended | API key from **Admin → Users → [your user] → Access tab → Login Type = API Key** |
+| `SUMMITAI_USERNAME` | Alt | Username — use if API key not available |
+| `SUMMITAI_PASSWORD` | Alt | Password — paired with USERNAME |
+| `SUMMITAI_ORG_ID` | No | Tenant/Org ID (default: `1`) |
+| `SUMMITAI_PROXY_ID` | No | Proxy ID (default: `0`) |
+| `SUMMITAI_LOG_LEVEL` | No | `DEBUG`, `INFO`, `WARNING` (default: `WARNING`) |
+
+> **Note**: Set `SUMMITAI_API_KEY` **or** both `SUMMITAI_USERNAME` + `SUMMITAI_PASSWORD`. API Key is the recommended auth method since SummitAI Sierra HF01+.
+
+---
+
+## Tools Reference
+
+### 🔴 Incident Management
+| Tool | Description |
+|---|---|
+| `create_incident` | Log a new Incident (New status) |
+| `update_incident` | Update status, assign, resolve, or close an Incident |
+| `get_incident` | Get full Incident details + change history |
+| `list_incidents` | Search/filter Incidents by status, workgroup, date range |
+
+### 🟡 Service Request
+| Tool | Description |
+|---|---|
+| `create_service_request` | Create SR from a Service Catalog item |
+| `update_service_request` | Update SR status, assignment, or remarks |
+| `get_service_request` | Get SR details + change history |
+| `list_service_requests` | Search/filter SRs |
+| `get_service_catalog` | Get catalog item details and custom fields |
+| `approve_service_request` | Approve or reject an SR |
+| `get_my_service_requests` | Get all SRs for a specific user |
+
+### 🟢 CMDB
+| Tool | Description |
+|---|---|
+| `create_or_update_ci` | Create or update a Configuration Item |
+| `get_ci` | Search and retrieve CI details |
+| `link_ci_relation` | Create relationships between CIs |
+| `get_cmdb_masters` | Get CI types, statuses, locations lookup data |
+
+### 🟠 Problem Management
+| Tool | Description |
+|---|---|
+| `create_or_update_problem` | Create or update a Problem Record |
+| `get_problem` | Get Problem Record details |
+
+### 🔵 Change Management
+| Tool | Description |
+|---|---|
+| `create_or_update_change` | Create or update a Change Record |
+| `get_change_record` | Get Change Record details |
+
+### ⚙️ Work Orders
+| Tool | Description |
+|---|---|
+| `create_work_order` | Create a Work Order for an IM or SR ticket |
+| `get_work_order` | Get Work Order details |
+
+### 📎 Attachments
+| Tool | Description |
+|---|---|
+| `upload_attachment` | Attach a file (base64) to any ITSM record |
+
+### 👤 Users & Admin
+| Tool | Description |
+|---|---|
+| `search_users` | Search users by email, employee ID, or name |
+| `create_or_update_user` | Create or update a user account |
+
+---
+
+## Setup for Claude Desktop
+
+Edit `%APPDATA%\Claude\claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "summitai": {
+      "command": "uvx",
+      "args": ["summitai-mcp"],
+      "env": {
+        "SUMMITAI_BASE_URL": "https://your-instance.symphonysummit.com",
+        "SUMMITAI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Setup for Antigravity (AGY)
+
+Edit your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "summitai": {
+      "command": "uvx",
+      "args": ["summitai-mcp"],
+      "env": {
+        "SUMMITAI_BASE_URL": "https://your-instance.symphonysummit.com",
+        "SUMMITAI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+---
+
+## How to Get Your API Key
+
+1. Log into your SummitAI/Apex instance as Admin
+2. Go to **Admin → Basic → Users**
+3. Find your user → click **Access** tab
+4. Set **Login Type** to **API Key**
+5. Copy the generated key
+
+---
+
+## API Reference
+
+All tools connect to the single SummitAI REST endpoint:
+```
+POST {SUMMITAI_BASE_URL}/REST/Summit_RESTWCF.svc/RESTService/CommonWS_JsonObjCall
+```
+
+Each tool sets the `ServiceName` field to route to the correct operation. Authentication is injected automatically from your environment variables.
+
+---
+
+## Development
+
+```bash
+# Clone and install dev dependencies
+git clone https://github.com/your-org/summitai-mcp
+cd summitai-mcp
+uv sync
+
+# Test with MCP Inspector (visual tool tester)
+uv run mcp dev src/summitai_mcp/server.py
+
+# Run tests
+uv run pytest tests/
+```
+
+---
+
+## Publishing to PyPI
+
+```bash
+uv build
+uvx twine upload dist/*
+```
+
+---
+
+## License
+
+MIT

summitai_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "summitai-mcp"
+version = "0.1.0"
+description = "MCP server for SymphonyAI SummitAI/Apex ITSM platform — Incident, Service Request, CMDB, Problem, Change, Work Order, Attachments, and User management"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+  { name = "Symphony Team" },
+]
+keywords = ["mcp", "symphonyai", "summitai", "itsm", "apex", "incident-management", "service-request", "cmdb"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: System Administrators",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: System :: Systems Administration",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "mcp>=1.0.0,<2.0.0",
+  "httpx>=0.27.0",
+  "pydantic>=2.0.0",
+  "pydantic-settings>=2.0.0",
+]
+
+[project.scripts]
+summitai-mcp = "summitai_mcp.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/your-org/summitai-mcp"
+Documentation = "https://github.com/your-org/summitai-mcp#readme"
+"Bug Tracker" = "https://github.com/your-org/summitai-mcp/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/summitai_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/",
+  "README.md",
+  "CHANGELOG.md",
+  "LICENSE",
+]

summitai_mcp-0.1.0/src/summitai_mcp/__init__.py

@@ -0,0 +1,6 @@
+"""SummitAI MCP Server — SymphonyAI ITSM integration for AI assistants."""
+
+__version__ = "0.1.0"
+__all__ = ["create_server"]
+
+from .server import create_server

summitai_mcp-0.1.0/src/summitai_mcp/__main__.py

@@ -0,0 +1,103 @@
+"""
+SummitAI MCP Server — entry point.
+
+Reads configuration from environment variables and launches the MCP server
+over stdio transport (compatible with Claude Desktop, Cursor, Antigravity, etc.)
+
+Environment variables:
+    SUMMITAI_BASE_URL   (required) Base URL of your SummitAI instance
+                        e.g. https://your-company.symphonysummit.com
+    SUMMITAI_API_KEY    (recommended) API key from Admin > Users > Access tab
+    SUMMITAI_USERNAME   (legacy) Username — use if API key not available
+    SUMMITAI_PASSWORD   (legacy) Password — paired with SUMMITAI_USERNAME
+    SUMMITAI_ORG_ID     Org/Tenant ID (default: 1)
+    SUMMITAI_PROXY_ID   Proxy ID (default: 0)
+    SUMMITAI_LOG_LEVEL  Logging level: DEBUG, INFO, WARNING (default: WARNING)
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+import os
+import sys
+
+
+def _configure_logging() -> None:
+    """Configure logging to stderr only (stdout is reserved for MCP stdio)."""
+    level = os.environ.get("SUMMITAI_LOG_LEVEL", "WARNING").upper()
+    logging.basicConfig(
+        stream=sys.stderr,
+        level=getattr(logging, level, logging.WARNING),
+        format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+    )
+
+
+def main() -> None:
+    """Entry point for uvx / pip-installed CLI invocation."""
+    _configure_logging()
+
+    mock_mode = os.environ.get("SUMMITAI_MOCK", "").strip().lower() in ("true", "1", "yes")
+
+    if mock_mode:
+        print(
+            "⚠️  MOCK MODE ENABLED (SUMMITAI_MOCK=true)\n"
+            "   All responses are fake. Set a real SUMMITAI_API_KEY to connect to live data.",
+            file=sys.stderr,
+        )
+        from .mock_client import MockSummitAIClient
+        from .server import create_server
+        client = MockSummitAIClient()
+        mcp = create_server(client)
+        mcp.run(transport="stdio")
+        return
+
+    # Validate required config before importing heavy deps
+    base_url = os.environ.get("SUMMITAI_BASE_URL", "").strip()
+    api_key = os.environ.get("SUMMITAI_API_KEY", "").strip() or None
+    username = os.environ.get("SUMMITAI_USERNAME", "").strip() or None
+    password = os.environ.get("SUMMITAI_PASSWORD", "").strip() or None
+    org_id = int(os.environ.get("SUMMITAI_ORG_ID", "1"))
+    proxy_id = int(os.environ.get("SUMMITAI_PROXY_ID", "0"))
+
+    if not base_url:
+        print(
+            "ERROR: SUMMITAI_BASE_URL environment variable is required.\n"
+            "Example: export SUMMITAI_BASE_URL=https://your-instance.symphonysummit.com\n\n"
+            "Tip: Run in mock/demo mode (no API key needed):\n"
+            "  set SUMMITAI_MOCK=true",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    if not api_key and not (username and password):
+        print(
+            "ERROR: Authentication required.\n"
+            "Set SUMMITAI_API_KEY (recommended), OR both SUMMITAI_USERNAME and SUMMITAI_PASSWORD.\n\n"
+            "Tip: Run in mock/demo mode (no API key needed):\n"
+            "  set SUMMITAI_MOCK=true",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    # Import here so errors above show cleanly
+    from .client import SummitAIClient
+    from .server import create_server
+
+    client = SummitAIClient(
+        base_url=base_url,
+        api_key=api_key,
+        username=username,
+        password=password,
+        org_id=org_id,
+        proxy_id=proxy_id,
+    )
+
+    mcp = create_server(client)
+
+    # Run with stdio transport (the MCP standard for local AI tools)
+    mcp.run(transport="stdio")
+
+
+
+if __name__ == "__main__":
+    main()