Translation Helps MCP
MCP Server for aggregating Bible translation resources from Door43
Installation
npx translation-helps-mcpAsk AI about Translation Helps MCP
Powered by Claude Β· Grounded in docs
I know everything about Translation Helps MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Translation Helps MCP Server v6.6.3
π¨ MAJOR UPDATE: 100% Real Data - Zero Mock Fallbacks
A comprehensive MCP (Model Context Protocol) server that provides AI agents with access to Bible translation resources from Door43's Content Service (DCS). This server enables AI assistants to fetch, process, and intelligently work with translation helps including scripture texts, translation notes, translation words, and translation questions.
π What's New in v6.6.3
Complete Architecture Overhaul
- β 100% Real Data - All mock data removed, every endpoint fetches from DCS
- β
Unified Architecture - Single
UnifiedResourceFetcherclass handles all data - β
Markdown Support Everywhere - All endpoints support
format=mdfor LLMs - β Wrangler-Only Testing - Standardized on port 8787 with real KV/R2 bindings
- β No Mock Fallbacks - Real errors instead of fake success
Breaking Changes
Removed Endpoints:
/api/fetch-ult-scriptureβ Usefetch-scripture?resource=ult/api/fetch-ust-scriptureβ Usefetch-scripture?resource=ust/api/fetch-resourcesβ Use specific endpoints/api/resource-recommendationsβ Removed completely/api/language-coverageβ Removed completely/api/get-words-for-referenceβ Usefetch-translation-words
See MIGRATION_GUIDE.md for detailed migration instructions.
π Key Features
Core Translation Resources
- Scripture Texts: Multiple translations (ULT, UST, T4T, UEB) with real-time DCS fetching
- Translation Notes: Verse-by-verse explanations from TSV data
- Translation Words: Biblical term definitions from markdown files
- Translation Word Links: Connections between scripture and word articles
- Translation Questions: Comprehension questions from TSV data
- Translation Academy: Training modules for translators
π€ MCP Prompts (NEW!)
Guided workflows that teach AI assistants to chain tools intelligently:
translation-helps-for-passage- Get everything: scripture + notes + questions + words (with titles) + academy articlesget-translation-words-for-passage- Show dictionary entry titles (not technical IDs)get-translation-academy-for-passage- Find training articles referenced in notes
π Complete Usage Guide β | π Technical Docs β
Why prompts matter:
- One command replaces 6-10 tool calls
- Shows human-readable titles instead of IDs
- Standardizes best practices for translation workflows
- Makes AI assistants much smarter about Bible translation
Technical Excellence
- Real Data Only: No mock data, no fake responses, no fallbacks
- Unified Fetcher: Single class (
UnifiedResourceFetcher) for all resources - Smart Caching: KV for catalogs, R2 for ZIPs, Cache API for extracted files
- Format Support: JSON, Markdown, Text, and TSV (where applicable)
- Cloudflare Pages: Global edge deployment with sub-100ms response times
π Deployment
Live Production
- API Base:
https://tc-helps.mcp.servant.bible/api/ - Documentation:
https://tc-helps.mcp.servant.bible/ - Health Check:
https://tc-helps.mcp.servant.bible/api/health
Quick Start
# Fetch scripture
curl "https://tc-helps.mcp.servant.bible/api/fetch-scripture?reference=John%203:16"
# Get translation notes in markdown (for LLMs)
curl "https://tc-helps.mcp.servant.bible/api/translation-notes?reference=Genesis%201:1&format=md"
# Fetch translation word links
curl "https://tc-helps.mcp.servant.bible/api/fetch-translation-word-links?reference=Titus%201:1"
# Browse translation academy modules
curl "https://tc-helps.mcp.servant.bible/api/browse-translation-academy?language=en"
π οΈ Architecture
Unified Data Fetching
All endpoints use the same architecture:
API Endpoint β createSimpleEndpoint β UnifiedResourceFetcher β ZipResourceFetcher2 β DCS
Key Components:
- UnifiedResourceFetcher - Single interface for all resource types
- ZipResourceFetcher2 - Handles ZIP archives with intelligent caching
- createSimpleEndpoint - Standardized endpoint creation pattern
- Real Error Handling - No mock fallbacks, actual error messages
Caching Strategy
DCS API β KV Cache (1hr TTL) β Catalog Metadata
β
R2 Storage β ZIP Files
β
Cache API β Extracted Files
π¨ Production Setup
β οΈ CRITICAL: R2 bucket must be populated with ZIP files for production to work!
See R2 Setup Guide for instructions on populating the R2 bucket.
π§ͺ Testing with Wrangler
β οΈ IMPORTANT: All tests MUST use Wrangler for KV/R2 functionality
Setup
# Start Wrangler (REQUIRED for tests)
cd ui && npx wrangler pages dev .svelte-kit/cloudflare --port 8787
# In another terminal, run tests
npm test
Test Configuration
- Port: Always 8787 (enforced by test setup)
- Bindings: Real KV and R2 bindings
- No Mocks: Tests use real Cloudflare services
See tests/TESTING_REQUIREMENTS.md for details.
π API Documentation
Scripture Endpoints
# Fetch multiple translations
GET /api/fetch-scripture?reference=John%203:16&resource=ult,ust
# Response format options
GET /api/fetch-scripture?reference=John%203:16&format=md # Markdown
GET /api/fetch-scripture?reference=John%203:16&format=text # Plain text
Translation Helps
# Translation notes (from TSV)
GET /api/translation-notes?reference=John%203:16
# Translation questions (from TSV)
GET /api/translation-questions?reference=John%203:16
# Translation words (from markdown)
GET /api/fetch-translation-words?reference=John%203:16
# Translation word links (from TSV) - NEW!
GET /api/fetch-translation-word-links?reference=John%203:16
# Translation academy modules
GET /api/fetch-translation-academy?moduleId=figs-metaphor
# Browse academy modules
GET /api/browse-translation-academy?language=en&category=translate
Discovery Endpoints
# Available languages
GET /api/simple-languages
# Available books
GET /api/get-available-books?language=en
# Resource catalog
GET /api/resource-catalog?language=en&subject=Bible
See API_ENDPOINTS.md for complete documentation.
π§ Development
Prerequisites
- Node.js 18+
- Wrangler CLI (
npm install -g wrangler)
Local Development
# Install dependencies
npm install
cd ui && npm install
# Start Wrangler dev server (REQUIRED)
cd ui && npx wrangler pages dev .svelte-kit/cloudflare --port 8787
# Run tests
npm test
# Build for production
npm run build
Development Standards
- KISS: Keep It Simple - no over-engineering
- DRY: Don't Repeat Yourself - single source of truth
- Consistent: Same patterns everywhere
- Antifragile: Fail fast with real errors, no hiding issues
π€ Contributing
- Fork the repository
- Create a feature branch
- Use Wrangler for all testing (no exceptions!)
- Ensure all tests pass
- Submit a pull request
Remember:
- No mock data
- All endpoints must support markdown format
- Use
UnifiedResourceFetcherfor new features - Test with real KV/R2 bindings
π License
MIT License - see LICENSE file for details.
Built with β€οΈ for Bible translators worldwide
