jueban-buddhist-companion

# Jueban · Buddhist Companion

Cross-platform connection package for Jueban's production, anonymous, read-only Buddhist scripture MCP server.

- MCP endpoint: `https://jueban.online/mcp`
- Connector package version: `1.0.2`
- Production MCP server version: `1.0.0`
- Authentication: none
- Account access: none
- Payment: none
- Tools: 4

## Capabilities

1. `search_buddhist_canon` — search traceable Buddhist scripture and sources.
2. `explain_buddhist_passage` — verify a passage, then keep scripture and explanation separate.
3. `find_passages_for_situation` — find source-backed passages relevant to a life situation.
4. `get_daily_practice` — create a one-time read, listen, or view practice.

Jueban V1.0 does not expose meditation, chanting, scripture-copying, account history, payments, or saved progress as MCP tools.

## Install

### Claude

Use the direct custom-connector link in [`claude/custom-connector-link.txt`](claude/custom-connector-link.txt), or configure Claude Code:

```bash
claude mcp add --transport http --scope user jueban https://jueban.online/mcp
```

This repository is also a Claude Code plugin. Its manifest is in
[`.claude-plugin/plugin.json`](.claude-plugin/plugin.json).

Add the official AssetGrid LLC marketplace and install the plugin:

```bash
claude plugin marketplace add assetgrid-llc/jueban-buddhist-companion
claude plugin install jueban-buddhist-companion@assetgrid-llc
```

### Cursor and compatible Agent Plugin clients

The portable Agent Plugin manifests are [`plugin.json`](plugin.json) and
[`mcp.json`](mcp.json). They connect directly to the same anonymous,
read-only production MCP endpoint.

[Add Jueban MCP to Cursor](https://cursor.com/link/mcp/install?name=jueban&config=eyJ1cmwiOiJodHRwczovL2p1ZWJhbi5vbmxpbmUvbWNwIn0%3D)

### VS Code and GitHub Copilot CLI

Add the remote server to VS Code:

```bash
code --add-mcp '{"name":"jueban","type":"http","url":"https://jueban.online/mcp"}'
```

Add it to GitHub Copilot CLI:

```bash
copilot mcp add --transport http jueban https://jueban.online/mcp
```

GitHub Copilot CLI can also read this repository's root [`.mcp.json`](.mcp.json).

### Cline

Add the production server with the Cline CLI:

```bash
cline mcp install jueban --transport http https://jueban.online/mcp --yes
```

The public Cline Marketplace submission is tracked in
[`cline/marketplace#54`](https://github.com/cline/marketplace/pull/54).

### Docker MCP Toolkit

The remote-server catalog submission is tracked in
[`docker/mcp-registry#4750`](https://github.com/docker/mcp-registry/pull/4750).

### Gemini CLI

Install this repository as a Gemini CLI extension:

```bash
gemini extensions install https://github.com/assetgrid-llc/jueban-buddhist-companion
```

For a direct local connection:

```bash
gemini mcp add -s user -t http --description "Jueban Buddhist Companion: anonymous read-only source-backed Buddhist canon tools" jueban https://jueban.online/mcp
```

### Qwen Code

Install this repository as a Qwen Code extension:

```bash
qwen extensions install assetgrid-llc/jueban-buddhist-companion
```

For a direct local connection:

```bash
qwen mcp add --scope user --transport http --description "Jueban Buddhist Companion: anonymous read-only source-backed Buddhist canon tools" jueban https://jueban.online/mcp
```

### DeepSeek Harness

Run the official Harness with the supplied profile patch:

```bash
npx @deepseek-ai/dsh web --patch deepseek/jueban.cordis.patch.yml
```

This is a DeepSeek developer-harness integration. DeepSeek's consumer chat product does not currently expose an equivalent public custom-MCP marketplace flow.

### Grok

For Grok chat, go to `https://grok.com/connectors`, choose **New Connector → Custom**, and enter:

```text
https://jueban.online/mcp
```

For Grok Build, install this repository as a plugin after it has been published to a public Git repository. The plugin's MCP configuration is in [`.mcp.json`](.mcp.json).

```bash
grok plugin install assetgrid-llc/jueban-buddhist-companion@v1.0.2 --trust
```

### MCP Registry

The official Registry metadata is in [`server.json`](server.json), under the
server name `io.github.assetgrid-llc/jueban-buddhist-companion`.

## License and scope

The connector packaging in this repository is licensed under the [Apache
License 2.0](LICENSE). See [NOTICE](NOTICE) for attribution and scope details.

The license covers only the files distributed in this connector repository,
including platform manifests, MCP configuration, integration documentation,
installation helpers, and the bundled integration skill. It does not license
Jueban's product source code, Buddhist scripture corpus or databases,
editorial or media content, server-side implementation, trademarks, logos, or
other brand assets except as required for reasonable attribution.

## Safety and privacy

- Source-backed scripture text must remain visibly distinct from modern explanation.
- No result should be presented as medical, mental-health, legal, or emergency advice.
- The tools are anonymous and read-only. They do not read or update a Jueban account, private history, saved items, subscription, payment state, or practice records.
- Privacy policy: https://jueban.online/privacy/
- Terms: https://jueban.online/terms/
- Security reports: [`SECURITY.md`](SECURITY.md)

## Verification

Run:

```bash
./scripts/validate-package.sh
```

The validation checks package structure and calls the live production MCP `initialize` and `tools/list` methods. It expects exactly the four V1.0 tools listed above.

## Distribution status

- Official public repository: https://github.com/assetgrid-llc/jueban-buddhist-companion
- Stable release: https://github.com/assetgrid-llc/jueban-buddhist-companion/releases/tag/v1.0.2
- Official MCP Registry: `io.github.assetgrid-llc/jueban-buddhist-companion` / `1.0.2`
- Cline Marketplace review: https://github.com/cline/marketplace/pull/54
- Docker MCP Catalog review: https://github.com/docker/mcp-registry/pull/4750
- xAI Plugin Marketplace review: https://github.com/xai-org/plugin-marketplace/pull/312
- The connector package is publicly viewable, installable, and licensed under Apache License 2.0 within the scope stated above.
- The source repository is owned by the official AssetGrid LLC GitHub organization.