semvec/pypi-packages huggingface dataset:
vcosmos-mcp-server 0.1.8
A Model Context Protocol (MCP) server for querying vCosmos Test Logic API - UUTs and Tasks
License: MIT
Requires Python: >=3.10
Keywords: api, automation, hp, mcp, model-context-protocol, test, vcosmos

# vCosmos UUT MCP Server

A Model Context Protocol (MCP) server that provides tools to query Units Under Test (UUTs) and tasks from the vCosmos Test Logic API.

The current MCP server support only 2 sample tools,
- **query_vcosmos_uuts**: List all UUTs in vCosmos with filters.
- **query_vcosmos_tasks**: List all tasks in vCosmos with filters.

📦 **Available on PyPI**: [vcosmos-mcp-server](https://pypi.org/project/vcosmos-mcp-server/)  
▶️ **Install & Run**:
```bash
uvx vcosmos-mcp-server
```

## 🚀 Quick Start

1. **Set your vCosmos token**:
   ```bash
   export VCOSMOS_TOKEN="your_token_here"   # Linux/Mac
   $env:VCOSMOS_TOKEN="your_token_here"     # PowerShell
   ```

2. **Run the server** (choose one option):

   - **Option A: Manual**  
     Run directly from command line:
     ```bash
     uvx vcosmos-mcp-server
     ```

   - **Option B: VS Code Integration (Recommended)**  
     Add this to your VS Code MCP settings:
     ```json
     {
       "servers": {
         "vcosmos": {
           "command": "uvx",
           "args": ["vcosmos-mcp-server"],
           "env": {
             "VCOSMOS_TOKEN": "your_token_here"
           }
         }
       }
     }
     ```

   - **Option C: SSE (Server-Sent Events)**  
     The current vcosmos-mcp-server uses stdio transport. If you want to use SSE transport, run with mcp-proxy:
     ```bash
     uvx mcp-proxy --host=0.0.0.0 --port=8087 --pass-environment uvx vcosmos-mcp-server
     ```

## 🏗️ Architecture

![Architecture Diagram](https://raw.githubusercontent.com/<your-repo>/main/docs/architecture.png)

## 📖 Documentation

- [Usage Guide](https://github.com/<your-repo>/docs/usage.md)
- [API Reference](https://github.com/<your-repo>/docs/api.md)

---

**Package Name**: `vcosmos-mcp-server`  
**Python**: 3.8+  
**License**: MIT