P6xer Mcp Server

P6XER MCP Server

mcp-name: io.github.osama-ata/p6xer-mcp-server

[](https://badge.fury.io/py/p6xer-mcp-server) [](https://www.python.org/downloads/) [](LICENSE) [](https://modelcontextprotocol.io)

A full-featured Model Context Protocol (MCP) server for Primavera P6 XER files, built on PyP6XER.

Exposes 13 Tools, 3 Resources, and 2 Prompts so any MCP-compatible AI client (Claude Desktop, Claude Code, Cursor, etc.) can interactively parse, query, and analyze .xer schedule files.

---

🚀 Features

🔧 Tools (13)

| Tool | Description | |------|-------------| | parse_xer_file | Parse an XER file — project list, totals, status breakdowns | | get_project_activities | Activities with filters: projectid, projectshortname, status, tasktype | | get_critical_path | Critical path activities (float ≤ 0), sorted by early start | | analyze_resource_utilization | Planned/actual hours & costs per resource; over-allocation flags | | check_schedule_quality | DCMA-style check: missing logic, long durations, high float, unresourced tasks | | get_resources | List resources, optionally filtered by type | | get_resource_assignments | Resource–activity assignments with enriched names and costs | | get_wbs | Work Breakdown Structure hierarchy | | get_relationships | Predecessor/successor relationships enriched with task codes | | get_calendars | Calendar definitions with hours-per-period data | | get_schedule_summary | At-a-glance stats: counts, date range, critical count | | get_earned_value | EVM: PV, EV, AC, CV, SV, CPI, SPI, EAC per project | | get_activity_detail | Full detail for one activity (preds + succs + resources) |

📋 Resources (3)

| URI | Description | |-----|-------------| | xer-project://{file_path}/{project_id} | Detailed text summary of a specific project | | xer-activities://{file_path} | Activities summary with status breakdown and duration stats | | xer-resources://{file_path} | Resources summary with type breakdown and assignment stats |

💬 Prompts (2)

| Prompt | Types | |--------|-------| | analyze_xer_project | general · schedule · resources · progress · quality | | xer_reporting_prompt | executive · detailed · critical_path · resource · milestone |

---

� Install from Store

Via PyPI (uvx — no install needed)

uvx p6xer-mcp-server

Via PyPI (pip)

pip install p6xer-mcp-server
p6xer-mcp-server

Via Smithery

Search for p6xer-mcp-server on smithery.ai and click Install. It will generate the correct Claude Desktop config automatically.

Via GitHub MCP Registry

The server is listed in the GitHub MCP Registry. In Claude Code:

claude mcp add p6xer -- uvx p6xer-mcp-server

Claude Desktop config (after PyPI install)

{
  "mcpServers": {
    "p6xer": {
      "command": "uvx",
      "args": ["p6xer-mcp-server"]
    }
  }
}

---

�📦 Installation

# Clone the repo
git clone https://github.com/osama-ata/p6xer-mcp-server.git
cd p6xer-mcp-server

# Install with uv (recommended)
uv sync

# Or with pip
pip install "mcp[cli]>=1.6.0,= 1.6.0, = 1.16.0`

---

## 📄 License

MIT

---

## 🚢 Publishing to PyPI (GitHub Actions + Trusted Publishing)

This repository includes a release workflow at `.github/workflows/publish-to-pypi.yml` based on the PyPA guide and `pypa/gh-action-pypi-publish`.

### 1) Configure Trusted Publishers

Create trusted publishers for this exact workflow file:

- PyPI: https://pypi.org/manage/account/publishing/
- TestPyPI: https://test.pypi.org/manage/account/publishing/

Use these values:

- Owner: `osama-ata`
- Repository: `p6xer-mcp-server`
- Workflow file: `publish-to-pypi.yml`
- Environment: `pypi` (for PyPI), `testpypi` (for TestPyPI)
- Project name: `p6xer-mcp-server`

### 2) Create GitHub Environments

In repository settings, create two environments:

- `pypi`
- `testpypi`

Recommended security setup:

- Require manual approval for `pypi`
- No approval required for `testpypi`

### 3) Build locally (optional sanity check)

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*

4) Release flow

• Push to main: publishes to TestPyPI
• Push tag v* (for example v0.1.1): publishes to PyPI

git tag v0.1.1
git push origin v0.1.1

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: osama-ata
• Source: osama-ata/p6xer-mcp-server
• License: MIT
• Homepage: https://pypi.org/project/p6xer-mcp-server/

Install and usage instructions live in the source repository linked above.