Metadata-Version: 2.4
Name: widesutra-mcp
Version: 0.1.1
Summary: MCP server for WideSutra — query Buddhist scriptures, collections, figures, and concepts from Claude, Cursor, and Windsurf
Project-URL: Homepage, https://widesutra.com
Project-URL: Repository, https://github.com/dobestan/widesutra-mcp
Author: WideHoly
License-Expression: MIT
License-File: LICENSE
Keywords: buddhism,buddhist-scripture,claude,cursor,dhammapada,mcp,pali-canon,sutra,tipitaka,windsurf
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Religion
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp[cli]<2.0,>=1.0
Description-Content-Type: text/markdown

# widesutra-mcp

[![PyPI](https://img.shields.io/pypi/v/widesutra-mcp)](https://pypi.org/project/widesutra-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/widesutra-mcp)](https://pypi.org/project/widesutra-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

MCP server for [WideSutra](https://widesutra.com) -- query Buddhist scriptures directly from Claude, Cursor, and Windsurf. Ask your AI assistant about Pali Canon passages, Mahayana sutras, Buddhist figures, and core concepts backed by 5 collections, 5,326 texts, Pali + English translations, 10 figures, and 15 concepts.

> **Explore Buddhist scriptures at [widesutra.com](https://widesutra.com)** -- [Collections](https://widesutra.com/collections/) | [Figures](https://widesutra.com/figures/) | [Concepts](https://widesutra.com/concepts/) | [Glossary](https://widesutra.com/glossary/)

## Table of Contents

- [Install](#install)
- [Configure](#configure)
  - [Claude Desktop](#claude-desktop)
  - [Cursor](#cursor)
  - [Windsurf](#windsurf)
- [Available Tools](#available-tools)
- [Example Conversations](#example-conversations)
- [Buddhist Scripture Collections](#buddhist-scripture-collections)
- [Environment Variables](#environment-variables)
- [Also Available](#also-available)
- [WideHoly Scripture Platform](#wideholy-scripture-platform)
- [License](#license)

## Install

```bash
pip install widesutra-mcp
```

Or with `uvx` (no install needed):

```bash
uvx widesutra-mcp
```

## Configure

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "widesutra": {
      "command": "uvx",
      "args": ["widesutra-mcp"]
    }
  }
}
```

### Cursor

In `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "widesutra": {
      "command": "uvx",
      "args": ["widesutra-mcp"]
    }
  }
}
```

### Windsurf

In `~/.windsurf/mcp.json`:

```json
{
  "mcpServers": {
    "widesutra": {
      "command": "uvx",
      "args": ["widesutra-mcp"]
    }
  }
}
```

## Available Tools

| Tool | Description | Example Args |
|------|-------------|-------------|
| `get_text` | Get a specific Buddhist scripture passage by book, chapter, and verse | `book="dhammapada", chapter=1, verse=1` |
| `search_sutra` | Search across 5,326 Buddhist texts by keyword | `query="four noble truths", limit=10` |
| `get_collection` | Get scripture collection details (Tipitaka, Mahayana Sutras, etc.) | `slug="tipitaka"` |
| `get_figure` | Get Buddhist figure info (Buddhas, bodhisattvas, arahants) | `slug="siddhartha-gautama"` |
| `get_concept` | Get Buddhist concept details (Four Noble Truths, Nirvana, etc.) | `slug="four-noble-truths"` |

## Example Conversations

**Reading scripture passages:**

> "Show me the first verse of the Dhammapada"
>
> "What does the Heart Sutra say about emptiness?"
>
> "Find passages about compassion in the Pali Canon"

**Exploring Buddhist teachings:**

> "Explain the Four Noble Truths with the original Pali terms"
>
> "What is the Noble Eightfold Path?"
>
> "Tell me about dependent origination"

**Learning about Buddhist figures:**

> "Who was Nagarjuna and what did he teach?"
>
> "Tell me about Avalokiteshvara in Mahayana Buddhism"
>
> "What collections are in the Tipitaka?"

## Buddhist Scripture Collections

WideSutra covers 5 major collections of Buddhist scriptures spanning Theravada and Mahayana traditions:

| Collection | Tradition | Description |
|------------|-----------|-------------|
| Tipitaka (Pali Canon) | Theravada | Three baskets: Vinaya, Sutta, and Abhidhamma Pitaka |
| Mahayana Sutras | Mahayana | Heart Sutra, Lotus Sutra, Diamond Sutra, and more |
| Chinese Agamas | East Asian | Chinese translations of early Buddhist discourses |
| Tibetan Kangyur | Tibetan | Translated words of the Buddha in the Tibetan canon |
| Gandharan Manuscripts | Early Buddhist | Ancient Gandhara region texts in Kharosthi script |

Translations include Bhikkhu Sujato (English), Bhikkhu Bodhi (English), and the original Pali texts. The API returns both translated text and original Pali where available.

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `WIDESUTRA_BASE_URL` | `https://widesutra.com/api/v1/sutra` | API base URL |

## Also Available

| Platform | Package | Install |
|----------|---------|---------|
| **PyPI** | [widesutra](https://pypi.org/project/widesutra/) | `pip install widesutra` |
| **npm** | [widesutra](https://www.npmjs.com/package/widesutra) | `npm install widesutra` |
| **Go** | [widesutra-go](https://pkg.go.dev/github.com/dobestan/widesutra-go) | `go get github.com/dobestan/widesutra-go` |
| **Rust** | [widesutra](https://crates.io/crates/widesutra) | `cargo add widesutra` |
| **Ruby** | [widesutra](https://rubygems.org/gems/widesutra) | `gem install widesutra` |

## WideHoly Scripture Platform

Part of the [WideHoly](https://wideholy.com) multi-religion scripture platform.

| Site | Domain | Focus |
|------|--------|-------|
| WideBible | [widebible.com](https://widebible.com) | 66 books, 4 translations (KJV, ASV, BBE, YLT), 3,000+ people, 942 places |
| WideQuran | [widequran.com](https://widequran.com) | 114 surahs, hadith collections, tafsir commentary |
| WideTorah | [widetorah.com](https://widetorah.com) | Tanakh, 54 parashot, Talmud tractates, Rashi commentary |
| WideGita | [widegita.com](https://widegita.com) | 18 Gita chapters, Upanishads, Yoga Sutras, Hindu deities |
| **WideSutra** | [widesutra.com](https://widesutra.com) | **5 collections, 5,326 texts, Pali + English, 10 figures, 15 concepts** |
| WideHoly | [wideholy.com](https://wideholy.com) | Cross-religion search, verse comparison, religious calendar |

## Learn More About Buddhist Scriptures

- **Scripture**: [Collections](https://widesutra.com/collections/) · [Translations](https://widesutra.com/developers/)
- **Reference**: [Figures](https://widesutra.com/figures/) · [Topics](https://widesutra.com/topics/) · [Glossary](https://widesutra.com/glossary/)
- **Study**: [Concepts](https://widesutra.com/concepts/) · [Pali Canon](https://widesutra.com/collections/)
- **Tools**: [Search](https://widesutra.com/) · [Developer Docs](https://widesutra.com/developers/)
- **API**: [Developer Docs](https://widesutra.com/developers/) · [OpenAPI Spec](https://widesutra.com/api/schema/)

## License

MIT
