使用说明内容（Markdown格式）

Study Bible MCP 服务器 – 使用指南

• 项目简介

  • 这是一个基于 MCP 标准的服务器端实现，提供圣经研究相关的数据、工具和提示模板，能够让 LLM 客户端（如 Claude）在对话中访问希腊语/希伯来语词汇、逐词分析、经文文本、跨引用、人名/地名等信息，并遵循 Fee & Stuart 的 hermeneutical framework 提供解释框架。

• 主要功能点

  • MCP 服务器核心：实现对客户端的 JSON-RPC 请求处理，提供工具注册、资源查询、提示模板等能力。
  • 可用工具（示例）：lookup_verse、word_study、search_lexicon、get_cross_references、lookup_name、parse_morphology、search_by_strongs。
  • 数据库支持：SQLite 数据库（约 120MB 数据集）+ 异步访问接口，包含词汇表、经文段落、跨引用、名称、形态学等表。
  • 数据来源：STEPBible 数据，包含 Greek/Hebrew 词汇、带形态标注的经文本、专有名词等。
  • Hermeneutics 框架：根据文本类型给出解经原则与方法（Epistles、OT narratives、Gospels、Psalms、Prophets 等）。
  • 传输模式：stdio（本地集成/开发调试）与 SSE（远程连接）两种传输方式，可在服务器启动时选择。
  • 自检与测试脚本：提供脚本用于测试数据库连通性与工具实现情况。

• 安装步骤

  • 安装依赖的运行环境（推荐使用 Python 3.10 及以上）。
  • 获取代码后，安装本项目依赖（可在项目根目录执行：pip install -e .）。
  • 下载 STEPBible 数据并构建数据库（可按以下顺序执行）：
    • 下载数据：运行脚本 scripts/download_stepbible.py，生成 data 目录中的 STEPBible 数据文件。
    • 构建数据库：运行脚本 scripts/build_database.py，生成 db/study_bible.db。
  • 启动服务器（两种传输模式可选）：
    • 本地开发/调试（stdio）: 运行 python -m study_bible_mcp.server --transport stdio
    • 远程/服务端（SSE）: 运行 python -m study_bible_mcp.server --transport sse --host 0.0.0.0 --port 8080
  • 如需自托管，请参考仓库中的 SELF_HOST 文档完成部署。

• 服务器配置（MCP 客户端所需的配置信息，JSON 格式描述，用于客户端了解如何启动/连接服务器） { "server_name": "study-bible", "description": "Study Bible MCP 服务器，提供希腊/希伯来语词汇、经文、跨引用、名称与形态学查询的后端", "command": "python", "args": ["-m", "study_bible_mcp.server", "--transport", "stdio"], "transport_options": { "stdio": { "purpose": "本地集成/调试传输，直接在进程内进行输入输出的通信" }, "sse": { "host": "0.0.0.0", "port": 8080, "notes": "可通过 SSE 端点 /sse 与客户端建立连接，支持远程访问" } } }

• 基本使用方法

  • 启动后，客户端通过 MCP 连接到服务器，使用提供的工具进行查询，例如查经文、分析关键单词、获取跨引用等。
  • 客户端在初始阶段应读取并使用服务器提供的工具列表，调用相应工具完成数据查询与分析，并结合 hermeneutics 指导进行解释。
  • 若使用 SSE 传输，可通过 /sse 端点进行连接；若使用 stdio 传输，则在同一进程内进行通信（常用于本地开发）。
  • 数据库需要在首次使用前完成下载与构建；若数据库不可用，应先执行数据下载与构建步骤。