Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Tripitaka MCP

by dhamma-seekerversion 1.3.0i★ 12iRuns in the cloudOfficial site ↗
Registry nameio.github.dhamma-seeker/tripitaka-mcp

How to install

What it does

MCP server for the full Pāli Canon — search, cite, compare translations. Offered as Dhamma Dāna.

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6291 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity13/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score33/100

Quality: Passed 4/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Tripitaka MCP. Follow https://mcp.popnx.com/i/dhamma-seeker-tripitaka-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/5 checks · What you ask goes through the maker’s server (mcp.tripitaka-mcp.com) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameTripitaka MCP
    Remote MCP server URL · Addresshttps://mcp.tripitaka-mcp.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsTripitaka MCP

  4. Try it

    Use Tripitaka MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Tripitaka MCP or shows a Tripitaka MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameTripitaka MCP
    Connection · Addresshttps://mcp.tripitaka-mcp.com/mcp
  3. Pick Tripitaka MCP in a chat

    Start a new chat and pick Tripitaka MCP from your plugins before typing

  4. Try it

    Use Tripitaka MCP and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Tripitaka MCP or shows a Tripitaka MCP tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user tripitaka https://mcp.tripitaka-mcp.com/mcp
  3. Type /mcp in Claude Code

    You should see Tripitaka MCP listed as connected

  4. Try it

    Use Tripitaka MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Tripitaka MCP or shows a Tripitaka MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Tripitaka MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Tripitaka MCP or shows a Tripitaka MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Tripitaka MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Tripitaka MCP or shows a Tripitaka MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.tripitaka-mcp.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Tripitaka MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user tripitaka https://mcp.tripitaka-mcp.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "tripitaka": {
      "url": "https://mcp.tripitaka-mcp.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "tripitaka": {
      "type": "http",
      "url": "https://mcp.tripitaka-mcp.com/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs in the cloud
Transport
streamable-http, sse
Latest versioni
1.3.0
Published to registryi
May 12, 2026
Code last changedi
Nov 17, 2026
Last checked
Nov 18, 2026
Maker
dhamma-seeker
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • search_by_keyword

    Keyword search across the Pāli Tipiṭaka (trigram word-similarity). Searches the configured enabled language(s) on the server. Filterable by pitaka and translation edition. 💡 **Hints for the AI client:** The system's canonical reference is Romanised Pāli (from SuttaCentral). If t

  • survey_corpus

    Exhaustively survey the WHOLE Tipiṭaka for a term — guaranteed complete. Use this (not `search_by_keyword`) when the question is about **coverage or counting** rather than "show me the best passages": - "How many times does Kusinārā appear in the canon?" - "Every place ānāpānassa

  • get_sutta

    Fetch a sutta's content — OR its table of contents (`mode="outline"`). ⚡ **Decide which mode BEFORE calling — don't fetch the whole sutta and parse it yourself:** - The user wants the **structure / outline / table of contents**, or asks **"how many sections/parts"** / "what's in

  • search_semantic

    Semantic search — match by meaning, not exact words. Uses vector similarity (cosine distance) over `text_pali` embedded with a multilingual MiniLM model. 🤔 **In most cases you should use `search_hybrid` instead** — it combines this semantic search with keyword search and ranks b

  • search_hybrid

    Hybrid search — combines keyword + semantic search via RRF. Uses Reciprocal Rank Fusion (RRF) to merge exact-word results with meaning-based results. **This is the recommended tool for "discourses about X" / concept queries**, because the semantic side catches suttas that discuss

  • list_structure

    Show the structure of all three pitakas with coverage statistics. 💡 **Use this tool when:** - The user asks for an overview of the Tipiṭaka (what's in it / which collections). - You need to check coverage before promising a search will find something — `segment_count > 0` is the

  • get_reference

    Build a proper citation string for a sutta. 💡 **Use this tool when:** - The user wants a citation for academic work, an article, or a reference. - You need to know the canonical location of a sutta (pitaka / nikāya). - You want a ready-to-use formatted citation string. 🔗 vs `ge

  • list_editions

    List the translation editions available, with coverage stats. 💡 **Use this tool when:** - Before calling `compare_translations` or `get_sutta(edition=...)`, so you know which edition values are valid and worth comparing. - The user asks which editions are loaded in the DB. 🔍 **

  • compare_translations

    Compare every available translation for a single segment. 💡 **Use this tool when:** - The user asks about the meaning/translation of a single Pāli line and wants to see multiple translators side-by-side. - Checking how different translators interpret the same line — technical te

  • get_word_definition

    Look up the dictionary meaning of a Pāli word, with sutta context. Serves as a Pāli Dictionary Bridge — pairs the "definition" with the "context where the Buddha actually used the word". 📖 **About the dictionary sources:** This tool draws from multiple primary dictionaries, incl

  • verify_quote

    Verify, check, or confirm a Buddha quote — does the canon really say it? Fact-check a quotation attributed to the Buddha. Catches fake, misquoted, misattributed and misremembered passages, and finds the true reading. Paste a line that has been quoted or half-remembered — Pāli or

  • define_from_suttas

    Find how the **suttas and Vinaya define a Pāli term in their own words**. The canon defines its own terms with fixed formulas — "Katamañca … dukkhaṁ?" (what is X?) … "ayaṁ vuccati … dukkhaṁ" (this is called X), "X adhivacana" (X is a designation for …), or the Vinaya "X nāma". Th

  • parse_pali_word

    Strip Pāli inflectional suffixes to find the root form (basic stem). 💡 **Use this tool when:** - You find an inflected Pāli word (e.g. `dukkhassa`, `bhikkhūnaṁ`) and `get_word_definition` doesn't find it directly — Pāli inflects nouns across 7 cases × 2 numbers, ~16 forms per ro

  • open_sutta_viewer

    Open an interactive sutta viewer inside the chat — Pāli + English, plus an optional third row in the user's own language translated BY YOU. Renders each segment as: Pāli on top (canonical), the bilara-data English below it (verification anchor), and — when you supply `translation

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account dhamma-seeker, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 days ago

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • ✓ Pass

    Endpoint responds

    Responded in 446 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 14 tool descriptions and found no hidden instructions to the AI

The cloud address answered 4 of the last 4 checks · latest 446 ms · checked Nov 18, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/dhamma-seeker-tripitaka-mcp.svg)](https://mcp.popnx.com/en/servers/dhamma-seeker-tripitaka-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 93% of the other 6384 servers in this category
  • Published to the registry more recently than 11% of the other 6384 servers in this category
  • Basic checks equal to or better than 56% of the other 6384 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Tripitaka MCP safe?

It passed 4 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (1.3.0) reached the registry 6 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.2KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Tripitaka MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks4/55/52/44/44/44/4
LicenseNOASSERTIONMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Tripitaka MCP Server

An MCP server for searching and citing content from the Pāli Tipiṭaka. It lets AI clients such as Claude or Cursor look up suttas, quote the teachings, and compare translations across languages.

🙏 This project is offered as Dhamma Dāna: 100% free, non-commercial only.

License details: LICENSE (code) and NOTICE.md (data)

✨ Features

  • Full Tipiṭaka coverage, at parity with SuttaCentral. All three baskets are indexed, about 444K segments. Sutta carries Pāli plus English from bilara-data's translators (Bhikkhu Sujato for DN/MN/SN/AN and most of the Khuddaka Nikāya, with John Kelly, Bhikkhu Kovilo and others for a few KN books). Vinaya carries Pāli plus Bhikkhu Brahmali's English. Abhidhamma is Pāli only, because upstream bilara-data has no English for any Abhidhamma book. list_structure reports live counts.
  • Hybrid search merges keyword and semantic results through Reciprocal Rank Fusion (RRF). It is the most precise of the search tools and needs no configuration.
  • Keyword search with trigram fuzzy matching and cross-language alignment.
  • Semantic search by meaning, using vector similarity (pgvector).
  • Translation comparison across editions, aligned segment by segment.
  • Dictionary bridge with 20,000+ entries (P. A. Payutto, PTS, DPPN).
  • Sutta fetch and citations. Get a sutta by ID (mn1, pli-tv-bu-vb-pj1, patthana1.1) and generate a properly formatted academic citation.
  • Pāli word analyzer that strips inflectional suffixes to find the root form when a dictionary lookup misses (bhikkhūnaṁ → bhikkhu).
  • Cross-reference URLs in every response: a clickable deep link into the project's own bilingual reader (Pāli + English, with a segment anchor that highlights the cited verse). The reader renders SuttaCentral's bilara-data verbatim, so it is the authoritative text, and AI clients surface the link so users can verify the source in one click.
  • Dual transport: legacy SSE (/sse) and canonical Streamable HTTP (/mcp, MCP spec 2025-03-26).
  • MCP resources: tripitaka://structure, tripitaka://sutta/{id}, tripitaka://word/{w}, for clients that pin context as resources.
  • Curated reference pages at /topics/*: six markdown pages covering canon structure, getting started and tool selection, places (Mahājanapada, holy sites, cosmology), 10 foundational themes with locus classicus, about 30 major figures, and a phase-based timeline of the Buddha's 45-year mission. Sutta IDs are verified against live data, and an AI client can fetch one page instead of running 30+ tool calls.
  • Claude skill. skills/tipitaka-research.md is a ready-to-install workflow file that turns on a multi-step research pattern (clarify → verify coverage → search → drill in → cite) on Claude Desktop and Claude Code.
  • Postman collection included for testing the API.

🏗️ Tech stack

TechnologyRole
Python + FastMCPMCP Server
PostgreSQL + pgvectorDatabase + Vector Search
sentence-transformersEmbeddings for semantic search
Docker ComposeInfrastructure

🚀 Quick start

🌐 No setup: connect to the public Dhamma Dāna server

The maintainers run a free public instance at tripitaka-mcp.com.

EndpointUse
https://mcp.tripitaka-mcp.com/mcpStreamable HTTP (MCP spec 2025-03-26)
https://mcp.tripitaka-mcp.com/sseLegacy SSE (older clients)

Connecting Claude Desktop takes three steps. Nothing to install but Node.js, and no Docker or GPU.

1. Find your absolute npx path. Claude Desktop doesn't read your shell profile, so a bare npx won't resolve. Open a terminal:

which npx

example: /Users/you/.nvm/versions/node/v22.14.0/bin/npx

2. Open claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows) and add the entry below. Substitute YOUR_NPX_PATH with the output from step 1, and YOUR_NODE_BIN_DIR with that path's parent directory:

{

"mcpServers": { "tripitaka": { "command": "YOUR_NPX_PATH", "args": ["-y", "mcp-remote", "https://mcp.tripitaka-mcp.com/mcp"], "env": { "PATH": "YOUR_NODE_BIN_DIR:/usr/local/bin:/usr/bin:/bin" } } } }

3. Quit Claude Desktop completely (⌘Q on macOS, tray → Quit on Windows) and reopen. The 🔌 indicator in the bottom-left should show tripitaka with 14 tools available.

_The first connection takes 5 to 10 seconds_ while npx downloads mcp-remote on demand. Give Claude Desktop a moment after the restart before deciding it failed.

Once connected, try asking Claude things like:

  • "What does the Buddha teach about mindfulness of breathing? Quote the relevant passages from MN 118."
  • "Show me the full text of the Karaṇīyamettasutta in Pāli and English."
  • "What does the Pāli word _sati_ mean according to the Payutto dictionary?"
  • "Find suttas where the Buddha discusses anger."

Claude will pick the right tool, fetch the canonical Pāli, and surface a clickable link to the project's bilingual reader for verification.

The hosted server is a small free service offered for personal study, research, and dhamma practice. Keep your request rate reasonable; bursts may be throttled at the edge. Read NOTICE.md before redistributing it or using it commercially.

💻 Run it fully offline (pipx, local SQLite, no server)

If you would rather keep everything on your own machine, with no network calls to the hosted server, install the local edition. It carries the whole Pāli canon as a single SQLite file (~120 MB) and runs as a local stdio MCP server.

pipx install tripitaka-mcp     # needs Python 3.10+

tripitaka-mcp init # one-time: downloads the SQLite database tripitaka-mcp serve # runs the MCP server over stdio

If the install fails like this:

Because the current Python version (3.9.6) does not satisfy Python>=3.10

pipx is using a different interpreter than you think. It builds its own isolated environment on purpose and ignores whatever venv you have active, so an old system Python gets picked even when the shell you typed in has 3.12. Tell it which to use:

pipx install --python python3.12 tripitaka-mcp

(Any 3.10 or newer works; pipx environment shows what it defaults to.)

Then point Claude Desktop or Cursor at the local command, with no npx bridge and no internet:

{

"mcpServers": { "tripitaka": { "command": "tripitaka-mcp", "args": ["serve"] } } }

(If tripitaka-mcp isn't on the client's PATH, use the absolute path from which tripitaka-mcp.)

Need a URL instead of stdio? Scripts, notebooks, and anything that shares one server across several clients want an HTTP endpoint rather than a subprocess:

tripitaka-mcp serve --http                 # http://127.0.0.1:8765/mcp

tripitaka-mcp serve --http --port 9000 # or MCP_HOST / MCP_PORT

It binds 127.0.0.1 unless you say otherwise; the canon is read-only, but nothing here asks who is calling, so think before binding a public interface.

Hosted vs local

Both serve the same ~444K-segment canon. The differences:

Hosted (mcp.tripitaka-mcp.com)Local (pipx)
Toolsall 1411, or 12 with TRIPITAKA_MCP_APP=1; no search_semantic or search_hybrid
Concept / semantic search✅ vector search (pgvector)❌ use search_by_keyword instead
Keyword searchPostgreSQL trigram: fuzzy, typo tolerant, similarity rankedSQLite FTS5: whole-word / token match, so results and ranking can differ from hosted
Canon dataalways currenta snapshot from when you ran init; re-run tripitaka-mcp init to refresh
Updatesautomaticpipx upgrade tripitaka-mcp for code; re-run init for data
Privacyqueries reach the hosted server (nothing logged, see the Privacy Policy)nothing leaves your machine
Internetrequirednot needed after init
Rate limitbursts may be throttled at the edgenone
Setupzero / one-clickPython 3.10+, pipx, one-time ~120 MB download

search_semantic, search_hybrid, and the trigram keyword index need PostgreSQL, pgvector, and a ~1 GB embedding model, which is more than a lightweight local install should carry, so they stay hosted-only. In local mode those two tools are never registered: a connected client sees only the 11 it can actually call.

Because the local server is a standard stdio MCP server, it also gives you a fully offline AI stack. Pair it with a local model such as Ollama and any MCP-capable chat UI, and nothing leaves your machine.

🏎️ Fastest local path: the installer (recommended for non-developers)
git clone https://github.com/dhamma-seeker/tripitaka-mcp.git

cd tripitaka-mcp ./scripts/install.sh

The installer downloads a prepared database dump from Hugging Face (dhamma-seeker/tripitaka-mcp-dump) and restores it for you, which brings setup down from two to four hours (loading the data, then generating embeddings) to about five minutes. (If a dump file is already on disk, the installer uses that copy instead.)

The installer will:

  1. Verify that docker, compose, openssl, and curl are installed
  2. Generate .env with random passwords (for both the admin and the readonly user)
  3. Download the dump from Hugging Face (if not already local)
  4. Start the DB and restore the dump
  5. Set up the readonly role and runtime timeouts
  6. Print a ready-to-paste Claude Desktop config

Options:

./scripts/install.sh --dump PATH          # use an existing dump file

./scripts/install.sh --dump-url URL # override the dump source ./scripts/install.sh --no-dump # skip restore (load data yourself later)


🔧 Manual setup (for developers)
1. Clone & setup
git clone https://github.com/dhamma-seeker/tripitaka-mcp.git

cd tripitaka-mcp cp .env.example .env

Set POSTGRES_PASSWORD in .env to a random password

2. Start database
docker compose up db -d
3. Install dependencies
python -m venv .venv

source .venv/bin/activate pip install -r requirements.txt

4. Initialize database & load data
# 1. Seed metadata (pitaka, nikāya)

python scripts/seed_metadata.py

2. Download & load Sutta Piṭaka data from SuttaCentral

python scripts/data_loader.py

3. Load Thai CC0 translations (Dhīranando & Jayasāro)

python scripts/load_thai_cc0.py

4. Load dictionaries (DPD, PTS, DPPN, and the Payutto dictionary)

python scripts/load_dictionary.py

5. Generate embeddings for semantic / hybrid search

python scripts/generate_embeddings.py

5. Run MCP server
python main.py

Only the beginning is shown; read the rest in the repo