# CBETA MCP 服务器
[English](./README.md)
为 [CBETA 线上阅读](https://cbetaonline.dila.edu.tw)（中华电子佛典协会）提供的 MCP (Model Context Protocol) 服务器。
> **CBETA** 收录超过一亿字的佛教经典，包括大正新脩大藏经、卍新纂续藏经等众多藏经。
## 功能
### 🔧 工具 (Tools)
| 工具名 | 描述 |
|-------|------|
| `search_sutra` | 搜索佛典经文 |
| `get_sutra_content` | 获取指定经典内容 |
| `get_work_info` | 获取作品详细信息 |
| `browse_catalog` | 浏览藏经目录 |
### 📚 资源 (Resources)
- `cbeta://catalog` - 完整藏经目录
### 💬 提示 (Prompts)
- `explain_sutra` - 解释佛经段落
- `buddhist_term` - 查询佛学术语
## 安装
### 方式一：本地部署 (Node.js)
```bash
# 克隆仓库
git clone https://github.com/your-username/cbeta-mcp.git
cd cbeta-mcp
# 安装依赖
npm install
# 构建
npm run build
# 运行
npm start
```
### 方式二：Cloudflare Workers 部署（推荐）
#### 前置条件
1. [Cloudflare 账号](https://dash.cloudflare.com/sign-up)
2. [Node.js](https://nodejs.org/) (v18+)
3. [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/)
#### 部署步骤
```bash
# 1. 克隆仓库
git clone https://github.com/your-username/cbeta-mcp.git
cd cbeta-mcp
# 2. 安装依赖
npm install
# 3. 登录 Cloudflare
npx wrangler login
# 4. 部署到 Cloudflare Workers
npm run deploy
```
部署完成后，你的 MCP 服务器将可通过以下地址访问：
```
https://cbeta-mcp.<你的子域名>.workers.dev
```
#### 本地开发
```bash
# 启动本地开发服务器
npm run dev:worker
# 使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector@latest
```
## 配置
### Claude Desktop 配置
在 Claude Desktop 配置文件中添加：
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
#### 本地服务器配置
```json
{
"mcpServers": {
"cbeta": {
"command": "node",
"args": ["C:\\path\\to\\cbeta-mcp\\dist\\index.js"]
}
}
}
```
#### Cloudflare Workers 配置
```json
{
"mcpServers": {
"cbeta": {
"command": "npx",
"args": [
"mcp-remote",
"https://cbeta-mcp.your-subdomain.workers.dev/sse"
]
}
}
}
```
## 常用作品 ID
| ID | 经名 | 梵文名 |
|----|------|--------|
| 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 参考
### search_sutra
搜索佛典经文。
**参数：**
- `query` (必填): 搜索关键词
- `scope` (可选): 搜索范围 (T, X, N 等)
- `page` (可选): 页码 (默认: 1)
- `limit` (可选): 每页结果数 (默认: 10)
### get_sutra_content
获取指定卷的内容。
**参数：**
- `work_id` (必填): 作品 ID (如 T0001)
- `juan` (可选): 卷号 (默认: 1)
- `format` (可选): 输出格式 ("text" 或 "html")
### browse_catalog
浏览藏经目录。
**参数：**
- `catalog_id` (可选): 要浏览的目录 ID
### get_work_info
获取作品详细信息。
**参数：**
- `work_id` (必填): 作品 ID
## 开发
```bash
# 安装依赖
npm install
# 构建本地版本
npm run build
# 构建 Workers 版本
npm run build:worker
# 使用 MCP Inspector 测试
npm run inspector
```
## 项目结构
```
cbeta-mcp/
├── src/
│ ├── index.ts # 本地 MCP 服务器入口
│ ├── worker.ts # Cloudflare Workers 入口
│ └── cbeta-api.ts # CBETA API 客户端
├── dist/ # 编译输出
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置 (本地)
├── tsconfig.worker.json # TypeScript 配置 (Workers)
├── wrangler.toml # Cloudflare Workers 配置
├── README.md # 英文文档
└── README.zh-CN.md # 中文文档
```
## 许可证
MIT
## 致谢
- [CBETA 中华电子佛典协会](https://www.cbeta.org)
- [法鼓文理学院](https://www.dila.edu.tw)
