# 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.
📦 **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
{
"mcpServers": {
"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
## 📖 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
Raw data
{
"_id": null,
"home_page": null,
"name": "vcosmos-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Iverson Lu <iverson.lu@hp.com>",
"keywords": "api, automation, hp, mcp, model-context-protocol, test, vcosmos",
"author": null,
"author_email": "Iverson Lu <iverson.lu@hp.com>",
"download_url": "https://files.pythonhosted.org/packages/af/24/f4aba17fe6f6ae3fffd51806aa4432a06b8c1ee6ff236238e4a200004e6c/vcosmos_mcp_server-0.1.7.tar.gz",
"platform": null,
"description": "# vCosmos UUT MCP Server\n\nA Model Context Protocol (MCP) server that provides tools to query Units Under Test (UUTs) and tasks from the vCosmos Test Logic API.\n\n\ud83d\udce6 **Available on PyPI**: [vcosmos-mcp-server](https://pypi.org/project/vcosmos-mcp-server/) \n\u25b6\ufe0f **Install & Run**:\n```bash\nuvx vcosmos-mcp-server\n```\n\n## \ud83d\ude80 Quick Start\n\n1. **Set your vCosmos token**:\n ```bash\n export VCOSMOS_TOKEN=\"your_token_here\" # Linux/Mac\n $env:VCOSMOS_TOKEN=\"your_token_here\" # PowerShell\n ```\n\n2. **Run the server** (choose one option):\n\n - **Option A: Manual** \n Run directly from command line:\n ```bash\n uvx vcosmos-mcp-server\n ```\n\n - **Option B: VS Code Integration (Recommended)** \n Add this to your VS Code MCP settings:\n ```json\n {\n \"mcpServers\": {\n \"vcosmos\": {\n \"command\": \"uvx\",\n \"args\": [\"vcosmos-mcp-server\"],\n \"env\": {\n \"VCOSMOS_TOKEN\": \"your_token_here\"\n }\n }\n }\n }\n ```\n\n - **Option C: SSE (Server-Sent Events)** \n The current vcosmos-mcp-server uses stdio transport. If you want to use SSE transport, run with mcp-proxy:\n ```bash\n uvx mcp-proxy --host=0.0.0.0 --port=8087 --pass-environment uvx vcosmos-mcp-server\n ```\n\n## \ud83c\udfd7\ufe0f Architecture\n\n\n\n## \ud83d\udcd6 Documentation\n\n- [Usage Guide](https://github.com/<your-repo>/docs/usage.md)\n- [API Reference](https://github.com/<your-repo>/docs/api.md)\n\n---\n\n**Package Name**: `vcosmos-mcp-server` \n**Python**: 3.8+ \n**License**: MIT\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Model Context Protocol (MCP) server for querying vCosmos Test Logic API - UUTs and Tasks",
"version": "0.1.7",
"project_urls": {
"Bug Tracker": "https://github.com/yourusername/vcosmos-mcp-server/issues",
"Documentation": "https://github.com/yourusername/vcosmos-mcp-server#readme",
"Homepage": "https://github.com/yourusername/vcosmos-mcp-server",
"Repository": "https://github.com/yourusername/vcosmos-mcp-server"
},
"split_keywords": [
"api",
" automation",
" hp",
" mcp",
" model-context-protocol",
" test",
" vcosmos"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e677e1f33a27f77dca4630cd43ad3d5d18d4ed3d24a51f7b6b93328a48c7ea06",
"md5": "40ebf417aa4daceed769ce34d72a0aab",
"sha256": "30ed83cce33a0ce8a6fa0e9b3a79fc9fe4cc7be73d375107fbed1768cadaf113"
},
"downloads": -1,
"filename": "vcosmos_mcp_server-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "40ebf417aa4daceed769ce34d72a0aab",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7743,
"upload_time": "2025-08-23T15:49:22",
"upload_time_iso_8601": "2025-08-23T15:49:22.226271Z",
"url": "https://files.pythonhosted.org/packages/e6/77/e1f33a27f77dca4630cd43ad3d5d18d4ed3d24a51f7b6b93328a48c7ea06/vcosmos_mcp_server-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "af24f4aba17fe6f6ae3fffd51806aa4432a06b8c1ee6ff236238e4a200004e6c",
"md5": "d2043a968d5e529ab43bec311ec754f8",
"sha256": "c973ec6242502a275d1686fa603a078099d48e5306e7fad8955b9be5653cc0b3"
},
"downloads": -1,
"filename": "vcosmos_mcp_server-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "d2043a968d5e529ab43bec311ec754f8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 27204,
"upload_time": "2025-08-23T15:49:23",
"upload_time_iso_8601": "2025-08-23T15:49:23.639955Z",
"url": "https://files.pythonhosted.org/packages/af/24/f4aba17fe6f6ae3fffd51806aa4432a06b8c1ee6ff236238e4a200004e6c/vcosmos_mcp_server-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-23 15:49:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "vcosmos-mcp-server",
"github_not_found": true,
"lcname": "vcosmos-mcp-server"
}
JSON
