{"id":50885922,"url":"https://github.com/kbennett2000/concord-mcp","last_synced_at":"2026-06-15T17:01:33.832Z","repository":{"id":364325046,"uuid":"1267392219","full_name":"kbennett2000/concord-mcp","owner":"kbennett2000","description":"Read-only MCP server for Concord — Scripture lookup, semantic search, places, journeys, and word study as LLM tools. LAN-first, fully offline.","archived":false,"fork":false,"pushed_at":"2026-06-12T16:20:26.000Z","size":149,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T16:25:04.661Z","etag":null,"topics":["bible","concord","fastmcp","llm-tools","mcp","offline-first","scripture","self-hosted"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kbennett2000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-12T13:52:59.000Z","updated_at":"2026-06-12T16:20:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kbennett2000/concord-mcp","commit_stats":null,"previous_names":["kbennett2000/concord-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kbennett2000/concord-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fconcord-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fconcord-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fconcord-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fconcord-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kbennett2000","download_url":"https://codeload.github.com/kbennett2000/concord-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fconcord-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34372130,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bible","concord","fastmcp","llm-tools","mcp","offline-first","scripture","self-hosted"],"created_at":"2026-06-15T17:01:32.803Z","updated_at":"2026-06-15T17:01:33.823Z","avatar_url":"https://github.com/kbennett2000.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![concord-mcp — looked up, never made up.](docs/banner.svg)\n\nMaybe this has happened to you: you asked ChatGPT or another AI assistant for a\nBible verse, and it gave you one — confident, beautiful, and not actually in the\nBible. These assistants answer from memory, and their memory of Scripture is\nimperfect. concord-mcp fixes that one thing: **every verse your assistant shows\nyou is fetched from a real Bible on your own computer**, with a reference like\n*John 3:16 (KJV)* you can check for yourself.\n\n**Are you a developer?** Everything technical is in\n[docs/DEVELOPERS.md](docs/DEVELOPERS.md).\n\n## What this actually is, in plain words\n\nThree pieces work together:\n\n- **Claude** is the AI assistant — the one you talk to. It's made by a company\n  called Anthropic, and you use it through a free app called Claude Desktop.\n- **Concord** is a real Bible that lives on your computer — several complete\n  translations, plus maps, study references, and the original Greek and Hebrew,\n  all stored locally.\n- **concord-mcp** (this project) is the connector. It hands the assistant one\n  rule: *look it up, don't recall it.*\n\nThink of a librarian with a card catalog. A good librarian doesn't quote books\nfrom memory — she walks to the shelf, opens the book, and reads you the line,\nspine in hand. concord-mcp gives your assistant the catalog and the shelf.\n\nOnce connected, the assistant can:\n\n- find any verse by its reference (\"What does John 3:16 say?\")\n- find a verse by its exact wording (\"the one about still waters\")\n- search by idea — \"verses about anxiety\" — even when the word never appears\n- look up what the Bible says about a subject, using a century-old study index\n  compiled by hand\n- show the passages generations of readers have connected to a verse\n- show the Greek or Hebrew behind a verse, word by word\n- explain what an original-language word actually means\n- tell you where a place was — and honestly say \"location unknown\" when no one\n  knows\n- walk the great journeys, like Paul's travels, stop by stop with sources\n- hand you a verse at random, for a verse of the day\n\nNo menus, no commands — you just ask in plain English, and the assistant\nchooses how to look it up.\n\n**Want to build this yourself?**\n[concord-tutorial-ai](https://github.com/kbennett2000/concord-tutorial-ai) is\na free five-lesson course that hand-rolls the small version of exactly this\nserver — the loop, the one rule, the honest errors — in plain JavaScript, no\nAI experience needed. By the last lesson you're reading this repo's source at\nits v1.0.0 tag and recognizing every part.\n\n## Why you might want this\n\n- **Quotes you can check.** Every verse arrives with its reference. Open your\n  own Bible to the same place — it will be there.\n- **Search by meaning.** \"Verses about anxiety\" finds Matthew 6 even though the\n  word \"anxiety\" isn't in it.\n- **Word-study depth without seminary software.** Ask why John 21 uses two\n  different Greek words for \"love\" and watch the answer come from the actual\n  Greek text.\n- **Honest unknowns.** Ask where the land of Nod was, and you'll be told the\n  truth: no one knows. No invented map pins.\n- **The Bible stays home.** The Scripture data sits on your machine, not on\n  someone's server.\n\n## Honest downsides\n\nWorth knowing before you spend an evening on setup:\n\n- **Your conversation travels.** The Bible lives on your computer, but Claude\n  is an internet service — your *questions and its answers* go to the company\n  that runs it, like any chat service. (Fully private setups exist, but they're\n  technical — see [docs/DEVELOPERS.md](docs/DEVELOPERS.md).)\n- **The guarantee covers the quotes, not the commentary.** When the assistant\n  quotes a verse, that quote came off the shelf. But its *explanations* are\n  still an AI talking — thoughtful-sounding, sometimes wrong. Treat it as a\n  study aid, not a pastor. That's exactly why every quote carries a reference:\n  so you can open the passage yourself.\n- **Setup takes real effort.** This is the most involved project in the Concord\n  family: three free programs and one settings file, and the first time\n  through expect 30–45 minutes. The steps below assume nothing.\n- **The translations are older ones.** Concord ships public-domain Bibles —\n  the King James and its relatives. Faithful, beloved, and in older English;\n  modern copyrighted translations (NIV, ESV) are not included.\n\n## What you'll need\n\n- A computer (Windows or Mac) with about 2 GB of free disk space\n- An internet connection for the setup and for talking to Claude\n- A free [Claude](https://claude.ai) account\n- 30–45 minutes, once\n\n## Get it running\n\n**1. Install Docker Desktop.**\nDocker is a free tool that runs a program and everything it needs in a tidy,\nself-contained bundle — Concord arrives as one of those bundles. Download it\nfrom [docker.com](https://www.docker.com/products/docker-desktop/), install,\nand open it once so it's running (look for the whale icon).\n\n**2. Get Concord running.**\nConcord is the Bible itself. *(Already using songbird? You already have\nConcord running — skip ahead to step 3.)*\nFollow the two-step quickstart in\n[Concord's README](https://github.com/kbennett2000/concord#readme): download\nit, then start it with one command. When it's up, the Bible is being served on\nyour computer.\n\n**3. Install uv.**\nuv is a small free helper that downloads and runs this project for you.\n\n\u003cdetails\u003e\n\u003csummary\u003eOn a Mac\u003c/summary\u003e\n\nOpen the Terminal app, paste this line, and press Enter:\n\n```\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOn Windows\u003c/summary\u003e\n\nOpen PowerShell (search \"PowerShell\" in the Start menu), paste this line, and\npress Enter:\n\n```\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\u003c/details\u003e\n\n**4. Download this project.**\nClick the green **`Code`** button near the top of this page, then\n**Download ZIP**. Unzip it somewhere you'll be able to find again — your\nDocuments folder is fine. Remember where: you'll type that location in step 6.\n\n**5. Install Claude Desktop.**\nDownload it from [claude.ai/download](https://claude.ai/download), install,\nand sign in with your free account.\n\n**6. Tell Claude Desktop about the connector.**\nThis is the one fiddly step — a small settings file. In Claude Desktop, open\n**Settings → Developer → Edit Config**. That opens a file called\n`claude_desktop_config.json`.\n\n\u003cdetails\u003e\n\u003csummary\u003eWhere is that file, exactly?\u003c/summary\u003e\n\n- **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nThe Settings → Developer → Edit Config button takes you straight to it either\nway.\n\u003c/details\u003e\n\nReplace the file's contents with exactly this — changing only the one marked\nline to the folder where you unzipped this project in step 4:\n\n```json\n{\n  \"mcpServers\": {\n    \"concord\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"REPLACE-THIS/concord-mcp\", \"run\", \"concord-mcp\"]\n    }\n  }\n}\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eWhat do I put instead of REPLACE-THIS?\u003c/summary\u003e\n\nThe full location of the unzipped folder. For example:\n\n- Mac: `/Users/yourname/Documents/concord-mcp`\n- Windows: `C:\\\\Users\\\\yourname\\\\Documents\\\\concord-mcp` (in this file,\n  Windows paths need doubled backslashes, exactly like that)\n\u003c/details\u003e\n\nSave the file and **restart Claude Desktop** (fully quit it, then open it\nagain).\n\n**7. The first win.**\nLook for the small tools icon (a plug or sliders, near the message box) — that\nmeans Claude can see the connector. Now ask:\n\n\u003e *What does Psalm 23 say?*\n\nIf the answer comes back verse by verse, each line tagged like\n**Psalms 23:1 (KJV)** — it's working. Every one of those verses just came off\nthe shelf on your own computer.\n\n## Trouble?\n\n\u003cdetails\u003e\n\u003csummary\u003eClaude says \"Concord isn't reachable…\"\u003c/summary\u003e\n\nConcord (the Bible) isn't running. Open Docker Desktop, make sure it's started\n(the whale icon), and start Concord again per step 2. Then ask your question\nagain — no restart of Claude needed.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eNo tools icon after restarting Claude Desktop\u003c/summary\u003e\n\nAlmost always the path in the settings file. Open Settings → Developer → Edit\nConfig again and check the `REPLACE-THIS` line: it must be the real location\nof the unzipped folder, and on Windows every backslash must be doubled\n(`C:\\\\Users\\\\...`). Save and fully restart Claude Desktop again.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\"docker: command not found\" or nothing happens in step 2\u003c/summary\u003e\n\nDocker Desktop isn't running. Open it (look for the whale icon) and try again.\nIf it was never installed, that's step 1.\n\u003c/details\u003e\n\nStill stuck? [Open an Issue](https://github.com/kbennett2000/concord-mcp/issues)\nand describe where you got to — we'll help.\n\n## Part of the Concord family\n\n[Concord](https://github.com/kbennett2000/concord) is the Bible on your\ncomputer. [songbird](https://github.com/kbennett2000/songbird) is a quiet\nplace to read it and keep notes. concord-mcp connects it to an AI assistant —\nlooked up, never made up.\n\nMIT licensed. Built with care, for one real reader.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbennett2000%2Fconcord-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkbennett2000%2Fconcord-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbennett2000%2Fconcord-mcp/lists"}