English Français العربية

p6xer MCP Server

Registre officiel Autres

An MCP server for Primavera P6 XER files.

Code source Site web Documentation

Que pouvez-vous faire avec p6xer MCP Server ?

  • project_id – numeric P6 project ID (e.g. "1234")
  • project_short_name – project short name string (e.g. "PROJ1")

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package p6xer-mcp-server
Claude Code 
claude mcp add p6xer-mcp-server -e 'P6XER_API_KEY=<your p6xer_api_key>' -e 'P6XER_ENDPOINT=<P6XER_ENDPOINT>' -e 'P6XER_LOG_LEVEL=<P6XER_LOG_LEVEL>' -- uvx p6xer-mcp-server==0.1.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "p6xer-mcp-server": {
            "command": "uvx",
            "args": [
                "p6xer-mcp-server==0.1.3"
            ],
            "env": {
                "P6XER_API_KEY": "<your p6xer_api_key>",
                "P6XER_ENDPOINT": "<P6XER_ENDPOINT>",
                "P6XER_LOG_LEVEL": "<P6XER_LOG_LEVEL>"
            }
        }
    }
}

Variables d'environnement

  • P6XER_API_KEY secret API key used to authenticate with p6xer service.
  • P6XER_ENDPOINT Optional p6xer endpoint URL (default uses local p6xer daemon).
  • P6XER_LOG_LEVEL Optional log verbosity level (e.g., DEBUG, INFO, WARN, ERROR).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. P6XER MCP Server
  2. 🚀 Features
  3. � Install from Store
  4. �📦 Installation
  5. 🏃 Running
  6. 🔌 Claude Desktop
  7. 🔌 Claude Code (CLI)
  8. 💬 Example Prompts
  9. 📊 Tool Reference
  10. 🗂️ Project Structure
  11. 📋 Requirements
  12. 📄 License
  13. 🚢 Publishing to PyPI (GitHub Actions + Trusted Publishing)

P6XER MCP Server

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

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)
ToolDescription
parse_xer_fileParse an XER file — project list, totals, status breakdowns
get_project_activitiesActivities with filters: project_id, project_short_name, status, task_type
get_critical_pathCritical path activities (float ≤ 0), sorted by early start
analyze_resource_utilizationPlanned/actual hours & costs per resource; over-allocation flags
check_schedule_qualityDCMA-style check: missing logic, long durations, high float, unresourced tasks
get_resourcesList resources, optionally filtered by type
get_resource_assignmentsResource–activity assignments with enriched names and costs
get_wbsWork Breakdown Structure hierarchy
get_relationshipsPredecessor/successor relationships enriched with task codes
get_calendarsCalendar definitions with hours-per-period data
get_schedule_summaryAt-a-glance stats: counts, date range, critical count
get_earned_valueEVM: PV, EV, AC, CV, SV, CPI, SPI, EAC per project
get_activity_detailFull detail for one activity (preds + succs + resources)
📋 Resources (3)
URIDescription
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)
PromptTypes
analyze_xer_projectgeneral · schedule · resources · progress · quality
xer_reporting_promptexecutive · 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,<2.0.0" pyp6xer

🏃 Running

Development / MCP Inspector:

uv run mcp dev src/p6xer_mcp_server/server.py

Stdio (Claude Desktop / Claude Code):

uv run p6xer-mcp-server

🔌 Claude Desktop

Add to claude_desktop_config.json:

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

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

🔌 Claude Code (CLI)

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

💬 Example Prompts

Once connected:

Parse project.xer and give me an overview of all projects

What are all the critical path activities, sorted by start date?

Run a DCMA schedule quality check on project.xer

Calculate earned value metrics — what are the CPI and SPI?

Show all resource assignments for "John Smith"

What are the predecessors and successors of activity A1000?

List all over-allocated labor resources

Generate an executive summary report for project.xer

📊 Tool Reference

Filter parameters (most tools accept)
  • project_id – numeric P6 project ID (e.g. "1234")
  • project_short_name – project short name string (e.g. "PROJ1")
Status codes

TK_NotStart · TK_Active · TK_Complete

Task types

TT_Task · TT_Mile · TT_FinMile · TT_WBS

Resource types

RT_Labor · RT_Mat · RT_Equip

🗂️ Project Structure

p6xer-mcp-server/
├── src/
│   └── p6xer_mcp_server/
│       ├── __init__.py
│       └── server.py       # All tools, resources, and prompts
├── manifest.json           # MCPB bundle manifest
├── mcp.json                # MCP registry metadata
├── smithery.yaml           # Smithery registry configuration
├── pyproject.toml
└── README.md

📋 Requirements

  • Python ≥ 3.10
  • mcp[cli] >= 1.6.0, < 2.0.0
  • pyp6xer >= 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:

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)
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

Questions fréquentes

Qu'est-ce que p6xer MCP Server ?

An MCP server for Primavera P6 XER files.

Comment installer p6xer MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add p6xer-mcp-server -e 'P6XER_API_KEY=<your p6xer_api_key>' -e 'P6XER_ENDPOINT=<P6XER_ENDPOINT>' -e 'P6XER_LOG_LEVEL=<P6XER_LOG_LEVEL>' -- uvx p6xer-mcp-server==0.1.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour p6xer MCP Server ?

Oui. Il attend P6XER_API_KEY, à renseigner dans sa configuration.

p6xer MCP Server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient p6xer MCP Server ?

Il est publié par osama-ata. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.