Metadata-Version: 2.4
Name: pysphinx-mcp
Version: 0.1.0
Summary: MCP server for reading Sphinx documentation
Author: vmphase
Maintainer: vmphase
License: MIT
Project-URL: Repository, https://github.com/vmphse/pysphinx_mcp
Keywords: mcp,sphinx,documentation,docs,reader,model-context-protocol,opencode,claude
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<2,>=1.28.0
Requires-Dist: lxml<6,>=5.0.0
Requires-Dist: curl-cffi<1,>=0.9.0
Requires-Dist: msgspec<1,>=0.20.0
Dynamic: license-file

# pysphinx_mcp

MCP server for browsing, searching, and reading Sphinx documentation sites.

[![PyPI](https://img.shields.io/pypi/v/pysphinx_mcp)](https://pypi.org/project/pysphinx_mcp)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org)
[![License](https://img.shields.io/github/license/vmphase/pysphinx_mcp)](LICENSE)

## Tools

- `list_pages(base_url)`: all pages on a docs site
- `read_page(base_url, page_path)`: page content as clean text
- `search_docs(base_url, query)`: full-text search via Sphinx search index
- `list_sections(base_url, page_path)`: heading structure (h1-h4) of a page

## Install

```
pip install -U pysphinx_mcp
```

## Usage

Register with any MCP host:

```json
{
  "mcpServers": {
    "sphinx-docs": {
      "command": "python",
      "args": ["-m", "pysphinx_mcp"]
    }
  }
}
```

Or run directly:

```
python -m pysphinx_mcp
```
