Skip to main content
Glama
julienbrg

wisdom-mcp

by julienbrg
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

wisdom-mcp

An MCP server for agentic hybrid search over philosophical and spiritual texts, built on Kevin Owocki's Wisdom Context Window. The server only retrieves: your own model searches, reads, quotes and translates. See the design write-up.

Motivation

Ask a model what the Stoics or the Tao Te Ching say about anger and it will often paraphrase, or invent a plausible line with a plausible reference. For texts like these, the exact words and where they come from matter.

wisdom-mcp gives the model tools instead of answers. It searches a curated corpus with keywords and embeddings, then returns the original text with a precise reference. The model does the reasoning and translation, and quotes what it actually read. The corpus can grow without retraining anything, and every quote can be checked against its source.

Related MCP server: sefaria-api-mcp

Requirements

  • Node 24

  • pnpm 10

Setup

pnpm install
cp .env.example .env
pnpm build
pnpm start

The database is created at DATABASE_PATH on first boot, and migrations in migrations/ are applied in order.

Variable

Default

Purpose

PORT

3000

HTTP port, bound to 127.0.0.1

PUBLIC_URL

http://localhost:3000

Public origin; its host is allowed on /mcp

DATABASE_PATH

./data/app.db

SQLite file

CORPUS_CACHE

./data/cache

Downloaded texts used by the corpus import

Corpus

pnpm corpus:import

This imports the 8 pilot works from the Wisdom Context Window, with their original-language texts. Downloads are cached in CORPUS_CACHE, so later runs work offline, and each run replaces the works it imports.

Work

Translation

Reference

Original

Tao Te Ching

James Legge

chapter.para

Chinese Wikisource (王弼本)

Analects

James Legge

book.chapter

Chinese Wikisource

Dhammapada

F. Max Müller

verse

SuttaCentral

Bhagavad Gita

Edwin Arnold

chapter

gita/gita dataset

Enchiridion

Thomas Wentworth Higginson

section

Perseus

Meditations

Meric Casaubon

book.section

Perseus, by book

Sermon on the Mount

King James Version

chapter:verse

Perseus

Ecclesiastes

King James Version

chapter:verse

Sefaria

Every quotable passage has a reference and an original. Front matter, translators' notes, indexes and headings are kept but flagged is_apparatus.

Endpoints

  • POST /mcp: MCP over Streamable HTTP

  • GET /health: liveness check

  • GET /docs: Swagger UI

Scripts

Script

What it does

pnpm build

Compile to dist/

pnpm start

Run the compiled server

pnpm corpus:import

Import the pilot corpus

pnpm test

Build, then run the tests

pnpm lint

ESLint

pnpm format:check

Prettier check

pnpm typecheck

TypeScript without emitting

Credits

License

GPL-3.0

Contact

Julien Béranger (GitHub)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-sefaria

    pipeworx-io
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to access and query the Sefaria digital library of Jewish texts through natural language or direct tool calls.
    388 npm
    MIT

  • insight-mcp

    Airohh
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables hybrid document search (BM25 and dense) over a configurable corpus via MCP tools, returning passages and sources for AI agents to cite in answers.
    MIT