Skip to main content
Glama
Sign In
PI Doc MCP

PI Doc MCP

by nurnaufal321
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Aveva PI Doc MCP

Ground your AI answers in live AVEVA PI System documentation.

Python 3.11+ MCP License: MIT

What it does

PI Doc MCP is a Model Context Protocol (MCP) server that gives AI assistants like Claude direct access to the official AVEVA PI System documentation. Instead of relying on training data that may be outdated or incorrect, the AI fetches real answers from live docs — eliminating hallucination on PI-specific topics.

Results are scoped strictly to docs.aveva.com/category/pi-system. Other AVEVA product families (System Platform, CONNECT, etc.) are excluded by design.

Related MCP server: MCP Documentation Server

How it works

The server proxies the publicly accessible docs-be.aveva.com API in real time. No API key, no local doc files, no indexing step — every search and page fetch goes directly to AVEVA's documentation backend and returns content that is always up to date.

Prerequisites

Installation

1. Clone the repository

git clone https://github.com/naufal-halal/pi-doc-mcp.git
cd pi-doc-mcp

2. Install dependencies

uv sync

3. Register with Claude Code

claude mcp add pi-docs --scope user -- uv run --directory /path/to/pi-doc-mcp python server.py

Replace /path/to/pi-doc-mcp with the absolute path to the cloned folder.

4. Restart Claude Code to pick up the new MCP server. You should see pi-docs listed when you run:

claude mcp list

Available Tools

Once registered, Claude has access to three tools:

Tool

Description

search_pi_docs

Search PI System docs by keyword. Optional: bundle to scope to a specific product, n_results (default 5, max 20).

get_page

Fetch the full text of a documentation page by URL. Optional: max_chars (default 4000, max 12000).

list_pi_bundles

List all 90+ PI System documentation bundles grouped by product area (PI Server, PI Web API, Interfaces, Connectors, etc.).

Usage Examples

Ask Claude questions like:

  • "What authentication methods does PI Web API support?"

  • "What are the required tag attributes for the PI RDBMS Interface?"

  • "How do I configure buffering for a PI Interface on an interface node?"

  • "Show me the AF SDK getting started guide."

  • "List all available PI System documentation bundles."

Claude will search the live docs and cite the exact page it used.

Scope

This server covers documentation bundles under docs.aveva.com/category/pi-system, including:

  • PI Server (Windows and Linux)

  • PI Web API and AF SDK

  • PI Vision, PI DataLink, PI Manual Logger

  • PI Interfaces (OPC DA/HDA, RDBMS, UFL, Modbus, DNP3, Batch, and more)

  • PI Connectors (OPC UA, MQTT, BACnet, IEC 61850, and more)

  • Adapters for Edge Data Store

  • PI Integrators, PI SQL / OLEDB, PI OPC UA Server

Use list_pi_bundles inside Claude to see the full list.

References

Disclaimer

This project is not affiliated with, endorsed by, or supported by AVEVA. It proxies AVEVA's publicly accessible documentation API for personal and developer use. Users are responsible for complying with AVEVA's terms of use.

License

This project is licensed under the MIT License. See LICENSE for detils.

Available Tools

3 tools
get_pageB

Fetch the text of a PI System documentation page by URL.

Inputs: url (required), max_chars.

list_pi_bundlesA

List all PI System documentation bundles grouped by product area.

Inputs: no named parameters.

search_pi_docsA

Search AVEVA PI System documentation (scoped to docs.aveva.com/category/pi-system). Returns titles, URLs, and excerpts.

Inputs: query (required), bundle, n_results.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: search returns excerpts, get_page fetches full text by URL, list_bundles enumerates product areas. No overlap.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with underscores: search_pi_docs, get_page, list_pi_bundles. No mixed conventions.

    Tool Count5/5

    3 tools is well-scoped for a documentation server, covering search, retrieval, and browsing without unnecessary extras.

    Completeness5/5

    The set covers the core documentation workflow: find pages (search), read content (get_page), and explore structure (list_bundles). No obvious gaps.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • PI API MCP Server

      mingzilla
      A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables Claude and other MCP-compatible AI assistants to securely access and manage PI Dashboard resources including categories and charts.
      18
      9 npm
      6
      Apache 2.0

    • RL-MCP

      rlefko
      F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.
      2
      -

    • WinCC OA MCP Server

      winccoa-tools-pack
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that bridges AI assistants with WinCC OA projects, enabling natural language queries for datapoint search, manager management, and CTL script execution.
      2
      MIT