# CBETA MCP Server

[中文文档](./README.zh-CN.md)

MCP (Model Context Protocol) Server for [CBETA Online](https://cbetaonline.dila.edu.tw) - Chinese Buddhist Electronic Text Association.

> **CBETA** contains over 100 million characters of Buddhist scriptures, including the Taishō Tripiṭaka, Xuzangjing, and many other collections.

## Features

### 🔧 Tools

| Tool | Description |
|------|-------------|
| `search_sutra` | Search Buddhist scriptures by keyword |
| `get_sutra_content` | Get content of a specific scripture |
| `get_work_info` | Get detailed information about a work |
| `browse_catalog` | Browse the scripture catalog |

### 📚 Resources

- `cbeta://catalog` - Complete scripture catalog

### 💬 Prompts

- `explain_sutra` - Explain sutra passages
- `buddhist_term` - Look up Buddhist terminology

## Installation

### Option 1: Local (Node.js)

```bash
# Clone the repository
git clone https://github.com/your-username/cbeta-mcp.git
cd cbeta-mcp

# Install dependencies
npm install

# Build
npm run build

# Run
npm start
```

### Option 2: Cloudflare Workers (Recommended)

#### Prerequisites

1. [Cloudflare account](https://dash.cloudflare.com/sign-up)
2. [Node.js](https://nodejs.org/) (v18+)
3. [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/)

#### Deployment Steps

```bash
# 1. Clone the repository
git clone https://github.com/your-username/cbeta-mcp.git
cd cbeta-mcp

# 2. Install dependencies
npm install

# 3. Login to Cloudflare
npx wrangler login

# 4. Deploy to Cloudflare Workers
npm run deploy
```

After deployment, your MCP server will be available at:
```
https://cbeta-mcp.<your-subdomain>.workers.dev
```

#### Local Development

```bash
# Start local development server
npm run dev:worker

# Test with MCP Inspector
npx @modelcontextprotocol/inspector@latest
```

## Configuration

### Claude Desktop

Add to your Claude Desktop config file:

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

#### For Local Server

```json
{
  "mcpServers": {
    "cbeta": {
      "command": "node",
      "args": ["C:\\path\\to\\cbeta-mcp\\dist\\index.js"]
    }
  }
}
```

#### For Cloudflare Workers

```json
{
  "mcpServers": {
    "cbeta": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://cbeta-mcp.your-subdomain.workers.dev/sse"
      ]
    }
  }
}
```

## Common Work IDs

| ID | Title (Chinese) | Title (English) |
|----|-----------------|-----------------|
| T0001 | 長阿含經 | Dīrghāgama |
| T0099 | 雜阿含經 | Saṃyuktāgama |
| T0262 | 妙法蓮華經 | Lotus Sutra |
| T0374 | 大般涅槃經 | Mahāparinirvāṇa Sūtra |
| T0475 | 維摩詰所說經 | Vimalakīrti Nirdeśa Sūtra |
| T0665 | 金剛般若波羅蜜經 | Diamond Sutra |
| T0842 | 大毘盧遮那成佛神變加持經 | Mahāvairocana Sūtra |

## API Reference

### search_sutra

Search for Buddhist scriptures.

**Parameters:**
- `query` (required): Search keywords
- `scope` (optional): Search scope (T, X, N, etc.)
- `page` (optional): Page number (default: 1)
- `limit` (optional): Results per page (default: 10)

### get_sutra_content

Get the content of a specific volume.

**Parameters:**
- `work_id` (required): Work ID (e.g., T0001)
- `juan` (optional): Volume number (default: 1)
- `format` (optional): Output format ("text" or "html")

### browse_catalog

Browse the scripture catalog.

**Parameters:**
- `catalog_id` (optional): Catalog ID to browse

### get_work_info

Get detailed information about a work.

**Parameters:**
- `work_id` (required): Work ID

## Development

```bash
# Install dependencies
npm install

# Build local version
npm run build

# Build for Workers
npm run build:worker

# Run tests with MCP Inspector
npm run inspector
```

## License

MIT

## Credits

- [CBETA](https://www.cbeta.org) - Chinese Buddhist Electronic Text Association
- [DILA](https://www.dila.edu.tw) - Dharma Drum Institute of Liberal Arts