Translation Helps MCP

翻译帮助MCP服务器v7.19.29

一个全面的MCP（模型上下文协议）服务器，为AI代理提供从Door43的内容服务（DCS）访问圣经翻译资源的权限。该服务器使人工智能助手能够获取、处理和智能地处理翻译帮助，包括经文、翻译笔记、翻译单词和翻译问题。

v7.19的新增功能

多代理编排（v7.12+）

聊天系统现在使用复杂的多代理架构：

• 编排器代理 -分析查询并派遣专业代理
• 经文代理人 -获取圣经文本（ULT、UST翻译）
• Notes代理 -获取逐字翻译指导
• Words代理 -获取圣经术语定义
• 学院代理 -获取翻译概念文章
• 问题代理 -获取理解问题（v7.19）
• 搜索代理 -跨所有资源的语义搜索

User Query → Orchestrator → [Parallel Agent Dispatch] → Synthesis → Response

Cloudflare Workers AI（v7.11）

从OpenAI GPT-4o-mini迁移到 Cloudflare工人AI（Llama 4 Scout 17B）:

• 具有结构化输出的原生工具调用
• 边缘推理（无外部API调用）
• 聊天端点代码减少80%
• 多刀具请求的并行刀具执行

QA引文验证器（v7.18）

自动验证AI响应的准确性：

• 重新获取资源以验证引用
• 内联指标：已验证、不确定、无效
• X射线面板中的验证摘要
• 防止产生幻觉的引语

事件驱动搜索索引（v7.6-v7.8）

用于自动内容索引的两个队列管道：

ZIP Upload → R2 → Unzip Queue → Index Queue → AI Search

• 内存高效的一次一个文件提取
• 书本级分块（R2写入次数减少470倍）
• 搜索速度提高5-7倍（默认情况下仅矢量）

主要特点

核心翻译资源

• 圣经文本：具有实时DCS提取功能的多种翻译（ULT、UST、T4T、UEB）
• 翻译说明：TSV数据的逐节解释
• 翻译词汇：markdown文件中的圣经术语定义
• 翻译单词链接：经文和文字文章之间的联系
• 翻译问题：TSV数据中的理解问题
• 翻译学院：翻译培训模块

MCP提示

智能链接多个工具的引导式工作流程：

• translation-helps-for-passage -完整的翻译帮助（经文+笔记+问题+单词+学术）
• get-translation-words-for-passage -一篇文章的所有词典条目
• get-translation-academy-for-passage -注释中引用的培训文章

看 HOW_TO_USE_PROMPTS.md 使用指南。

人工智能驱动的搜索

跨所有圣经资源的语义搜索：

# Search for love in Translation Words
curl "https://translation-helps-mcp.pages.dev/api/search?query=what+does+love+mean&resource=tw"

# Search within John chapter 3
curl "https://translation-helps-mcp.pages.dev/api/search?query=believe&reference=John+3"

特征：

• Cloudflare AI搜索的语义理解
• 多过滤器支持（语言、组织、资源、参考）
• 带有格式化引用的丰富结果
• 情境预览

看 docs/HYBRID_搜索_饮食.md 文件。

AI聊天界面

内置聊天界面 /chat 与：

• 复杂查询的多代理编排
• 代理思想的实时流式传输
• X射线面板显示工具调用和计时
• 引文验证与来源验证
• 回复中可点击的文章链接

建筑

多代理聊天系统

┌─────────────────────────────────────────────────────────────┐
│                    User Query                                │
└─────────────────────┬───────────────────────────────────────┘
                      ▼
┌─────────────────────────────────────────────────────────────┐
│              Orchestrator (Llama 4 Scout 17B)               │
│         Analyzes query, plans agent dispatch                 │
└─────────────────────┬───────────────────────────────────────┘
                      ▼
    ┌────────┬────────┬────────┬────────┬────────┬────────┐
    │Scripture│ Notes │ Words │Academy │Questions│ Search │
    │ Agent  │ Agent │ Agent │ Agent  │ Agent  │ Agent  │
    └────┬───┴───┬───┴───┬───┴───┬────┴───┬────┴───┬────┘
         │       │       │       │        │        │
         └───────┴───────┴───┬───┴────────┴────────┘
                             ▼
┌─────────────────────────────────────────────────────────────┐
│           Synthesis + QA Citation Validation                 │
└─────────────────────────────────────────────────────────────┘
                             ▼
┌─────────────────────────────────────────────────────────────┐
│                 Streamed Response                            │
└─────────────────────────────────────────────────────────────┘

数据获取

API Endpoint → createSimpleEndpoint → UnifiedResourceFetcher → ZipResourceFetcher2 → DCS

缓存策略

DCS API → KV Cache (1hr TTL) → Catalog Metadata
        ↓
     R2 Storage → ZIP Files → Event Notification
        ↓                           ↓
    Cache API               Indexer Worker
        ↓                           ↓
  Extracted Files            AI Search Index

部署

现场制作

• 统一资源定位符: https://translation-helps-mcp.pages.dev/
• API基地: https://translation-helps-mcp.pages.dev/api/
• 聊天: https://translation-helps-mcp.pages.dev/chat
• 健康检查: https://translation-helps-mcp.pages.dev/api/health

快速开始

# Fetch scripture
curl "https://translation-helps-mcp.pages.dev/api/fetch-scripture?reference=John%203:16"

# Get translation notes in markdown
curl "https://translation-helps-mcp.pages.dev/api/translation-notes?reference=Genesis%201:1&format=md"

# Search for a term
curl "https://translation-helps-mcp.pages.dev/api/search?query=grace&resource=tw"

发展

先决条件

• Node.js 18+
• 牧马人CLI(npm install -g wrangler)

地方发展

# Install dependencies
npm install
cd ui && npm install

# Start development server
npm run dev

# Or with Wrangler for KV/R2 bindings
cd ui && npx wrangler pages dev .svelte-kit/cloudflare --port 8787

# Run tests
npm test

# Build for production
npm run build

使用Wrangler进行测试

所有测试必须使用Wrangler进行KV/R2功能：

# Start Wrangler (REQUIRED for tests)
cd ui && npx wrangler pages dev .svelte-kit/cloudflare --port 8787

# In another terminal, run tests
npm test

API 文档

经文终点

# 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

翻译帮助

# Translation notes
GET /api/translation-notes?reference=John%203:16

# Translation questions
GET /api/translation-questions?reference=John%203:16

# Translation words
GET /api/fetch-translation-words?reference=John%203:16

# Translation word links
GET /api/fetch-translation-word-links?reference=John%203:16

# Translation academy
GET /api/fetch-translation-academy?moduleId=figs-metaphor

发现端点

# 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

看 docs/API_ENDPOINTS.md文件 以获取完整的文档。

文档

• 实施指南 -设置和部署
• 建筑 -系统设计
• 多代理编排 -聊天架构
• 事件驱动索引 -搜索管道
• 故障排除 -常见问题

贡献

1. 分叉存储库
2. 创建要素分支
3. 使用Wrangler进行所有测试
4. 确保所有测试通过
5. 提交拉取请求

标准：

• KISS：保持简单
• DRY：不要重复自己
• 一致：到处都是相同的模式
• Antifragile：快速失败，出现真正的错误

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

为全球圣经翻译者精心打造