MCP服务器_FHL

Name: MCP服务器_FHL
Author: ytssamuel

作者：ytssamuel2 星标更新：2025-11-05

安装使用来源：spider==github.com

项目介绍

FHL 圣经 MCP 服务器 📖

这是一个基于 Model Context Protocol (MCP) 的服务器，用于访问信望爱站圣经 API。

📖 概述

FHL 圣经 MCP 服务器是基于 Model Context Protocol 的服务器，集成了由信望爱站 API 提供的丰富圣经资源。通过这个 MCP 服务器，AI 助手（如 Claude）可以直接访问专业学习资源，例如圣经经文、原文词汇分析、注释书籍和专题圣经研究。

✅ V0.1.2 最新版本 (2025-11-05)
所有已知问题均已修复（7/7 100%），包括滚动图像错误、Strong's 字典功能增强等。系统功能齐全且稳定。
📋 查看完整的修复报告 | 📝 变更日志

✨ 主要功能

🔍 经文查询 支持多种圣经翻译（包括联合版 KJV、现代中文翻译等）
📚 原文研究 提供希腊语和希伯来语原文分析及 Strong's 字典
💡 注释经典研究 搜索各种注释书籍和牧师讲道内容
🔎 经文搜索 关键词搜索和高级原文编号搜索
🎯 主题搜索 搜索与主题相关的圣经教导
🎵 音频圣经 获取多语言音频圣经连接
🌏 繁简体支持 完全支持繁简体切换

🚀 快速开始

🎯 方法 1：一键安装（推荐）

使用自动化安装脚本快速完成环境配置：

# 1. 下载项目
git clone https://github.com/ytssamuel/FHL_MCP_SERVER.git
cd FHL_MCP_SERVER

# 2. 执行一键安装
# Windows:
.\scripts\install.bat

# macOS/Linux:
chmod +x scripts/install.sh
bash scripts/install.sh

# 3. 生成配置（交互式）
python scripts/generate_config.py

脚本功能：

✅ 自动检查 Python 版本
✅ 创建虚拟环境
✅ 安装所有依赖项
✅ 验证安装结果
✅ 生成 AI 助手配置

📝 方法 2：手动安装

下载项目

git clone https://github.com/ytssamuel/FHL_MCP_SERVER.git
cd FHL_MCP_SERVER

安装依赖项

# Windows
python -m venv venv
.\venv\Scripts\activate
pip install -e .

# macOS/Linux
python3 -m venv venv
source venv/bin/activate
pip install -e .

配置 AI 助手

使用自动生成的脚本（推荐）：

python scripts/generate_config.py

或者选择您偏好的 AI 助手手动添加配置：

<details> <summary><b>Claude Desktop 配置</b> (推荐) ⭐</summary>

编辑配置文件（在 Windows 上为 %APPDATA%\Claude\claude_desktop_config.json 或在 macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

Windows:

{
  "mcpServers": {
    "fhl-bible": {
      "command": "C:\\path\\to\\FHL_MCP_SERVER\\venv\\Scripts\\python.exe",
      "args": ["-m", "fhl_bible_mcp"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\FHL_MCP_SERVER\\src",
        "LOG_LEVEL": "INFO",
        "FHL_CACHE_DIR": "C:\\path\\to\\FHL_MCP_SERVER\\.cache"
      }
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "fhl-bible": {
      "command": "/path/to/FHL_MCP_SERVER/venv/bin/python",
      "args": ["-m", "fhl_bible_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/FHL_MCP_SERVER/src",
        "LOG_LEVEL": "INFO",
        "FHL_CACHE_DIR": "/path/to/FHL_MCP_SERVER/.cache"
      }
    }
  }
}

⚠️ 重要：必须使用虚拟环境中的 Python 执行文件（venv/bin/python 或 venv/Scripts/python.exe），而不是系统中的 Python！

</details> <details> <summary><b>GitHub Copilot (VS Code) 配置</b> 💻</summary>

编辑 VS Code 设置（settings.json）：

Windows:

{
  "github.copilot.chat.mcp.enabled": true,
  "github.copilot.chat.mcp.servers": {
    "fhl-bible": {
      "command": "C:\\path\\to\\FHL_MCP_SERVER\\venv\\Scripts\\python.exe",
      "args": ["-m", "fhl_bible_mcp"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\FHL_MCP_SERVER\\src",
        "LOG_LEVEL": "INFO",
        "FHL_CACHE_DIR": "C:\\path\\to\\FHL_MCP_SERVER\\.cache"
      }
    }
  }
}

macOS/Linux:

{
  "github.copilot.chat.mcp.enabled": true,
  "github.copilot.chat.mcp.servers": {
    "fhl-bible": {
      "command": "/path/to/FHL_MCP_SERVER/venv/bin/python",
      "args": ["-m", "fhl_bible_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/FHL_MCP_SERVER/src",
        "LOG_LEVEL":  "INFO",
        "FHL_CACHE_DIR": "/path/to/FHL_MCP_SERVER/.cache"
      }
    }
  }
}

</details>

⚠️ 重要：

将 /path/to/FHL_MCP_SERVER 替换为您实际的项目路径

在 Windows 中使用双斜杠 \\ 或单斜杠 / 表示路径

PYTHONPATH 必须指向项目的 src 目录

开始使用

查询约翰福音 3:16
使用 basic_help_guide 查看完整功能

📖 详细的安装步骤 请参阅 完整安装指南

包括：

✅ 跨平台详细步骤（Windows/macOS/Linux）

✅ 三种类型的 AI 助手完全配置教程

✅ 常见问题排查

✅ 高级配置选项

🛠️ 安装辅助工具该项目提供了完整的自动化脚本以简化安装和配置过程： |脚本 | 功能 | 使用时机| quick_check.py | -------------------- | -------- | -------------------------------- | | install.bat/sh | 环境预检查 | 安装前检查 Python 版本和项目结构| | verify_setup.py | 一键安装 | 自动建立环境，安装依赖项并验证结果| | generate_config.py | 环境验证 | 安装后综合配置检查（9项检查）|

|| 配置生成 | 交互式生成 AI 助手配置文件|

# 1. 安装前检查
python scripts/quick_check.py

# 2. 一键安装
# Windows: .\scripts\install.bat
# Unix:    bash scripts/install.sh

# 3. 环境验证
python scripts/verify_setup.py

# 4. 生成配置
python scripts/generate_config.py

快速开始 :

请参阅详细说明

scripts/README.md

get_bible_verse 📚 可用工具
get_bible_chapter 经文查询
search_bible - 在指定章节中搜索圣经经文

- 整本圣经经文搜索

get_word_analysis - 在圣经中搜索关键词
lookup_strongs 原文研究
search_by_strongs - 获取词汇分析的经文

- 强大的原始字典搜索

get_commentary - 根据 Strong's 编号搜索经文
search_commentary 注释经典研究
get_topic_study - 获取圣经注释

- 注释内容搜索

get_apocrypha_verse - 搜索主题和经典
search_apocrypha 第二圣经和使徒之父 ⭐ 新增（JSON 格式输出）
list_apocrypha_books - 搜索第二圣经（旧约第二经典 101-115）以支持完整的书名，如“第一马加比书”和“本西拉智言”
get_apostolic_fathers_verse - 搜索次级内容
search_apostolic_fathers - 列出所有次级圣经
list_apostolic_fathers_books - 搜索使徒和父亲的圣经（201-217）

搜索使徒和父亲的内容 - 列出所有使徒和父亲的书籍💡 注意

第二圣经和使徒之父 API 使用结构化方法 JSON 格式输出，便于程序处理。详情见

get_footnote JSON 输出格式文档

脚注查询 ⭐ 新增

search_fhl_articles - 搜索圣经脚注（目前支持）TCV 版本）
list_fhl_article_columns 文章搜索 ⭐ 新增（JSON 格式输出）

搜索信望爱站的文章（8000+文章，支持全文或预览模式）- 列出可用的文章栏目💡 include_content=true 注意 : 文章 API 使用结构化方法 JSON 格式输出。预设返回内容预览（约 200 字），请设置以获取完整内容

. 详情见

list_bible_versions JSON 输出格式文档
list_commentaries 信息工具
get_book_list - 列出所有可用的圣经版本

- 列出所有可用的注释书籍

get_audio_bible - 获取圣经书籍列表

多媒体- 获取音频圣经连接总计: 27 个实用函数 | 更详细解释，请参阅

完整 API 文件

FHL 圣经 MCP 服务器
├── 工具 (Tools) - 执行动作和查询
├── 资源 (Resources) - 提供静态/动态数据
└── 提示 (Prompts) - 默认对话模板

.

🏗️ 架构

bible://verse/{version}/{book}/{chapter}/{verse} 📖 资源
bible://chapter/{version}/{book}/{chapter} 该服务器提供以下 URI 方案：
strongs://{testament}/{number} - 搜索特定经文
commentary://{book}/{chapter}/{verse} - 搜索整个章节的经文
info://versions - Strong's 字典资源
info://books - 注释资源
info://commentaries - 版本列表

- 书籍列表

注释列表 🎯 提示 内置

19 个

basic_help_guide 专业对话模板，涵盖从初学者到高级用户的完整研究需求：
basic_uri_demo 📘 基础 - 快速入门
basic_quick_lookup - 完整用户指南，初学者必读
basic_tool_reference - URI 使用演示，教你如何直接访问资源

- 快速圣经搜索，简单方便

reading_daily - 工具参考手册，详细说明所有功能
reading_chapter 📖 阅读 - 日常敬拜
reading_passage - 日常圣经阅读计划，结构化的灵修体验

- 阅读整章圣经，深入理解它

study_verse_deep - 圣经段落阅读，跨章节研究经文
study_topic_deep 🎓 学习 - 深入研究
study_translation_compare - 深入研究经文，专业解读和分析
study_word_original - 主题研究，全面探索圣经主题

- 版本比较，多种翻译比较

special_sermon_prep - 原始单词研究，希伯来语/希腊语分析
special_devotional 🎯 特别 - 专业应用
special_memory_verse - 讲道准备，全面课程准备资源
special_topical_chain - 灵修材料，适合个人/团体/家庭
special_bible_trivia - 圣经辅助，记忆技巧和计划

- 主题链，追踪贯穿圣经的主题

advanced_cross_reference - 圣经问答，互动知识测试
advanced_parallel_gospels 🚀 高级 - 专业研究
advanced_character_study - 交叉引用分析，多层次引用网络（1-3 层深）

对比象征福音和平行比较四福音 - 圣经人物研究，从九个维度进行全面分析💡 basic_help_guide 提示
：使用提示查看完整功能介绍和使用教程！

📚 详细说明，请参阅

提示用户指南

# 安装开发依赖
pip install -e ".[dev]"

# 执行测试
pytest

# 执行 linting
ruff check .

# 格式化代码
black .

# 类型检查
mypy src/

🔧 开发

FHL_MCP_SERVER/
├── src/fhl_bible_mcp/
│   ├── api/          # API 客户端
│   ├── models/       # 数据模型
│   ├── tools/        # MCP 工具
│   ├── resources/    # MCP 资源
│   ├── prompts/      # MCP 提示
│   └── utils/        # 工具函数
├── tests/            # 测试
├── docs/             # 文档
└── pyproject.toml    # 项目设置

设置开发环境

项目结构

重要通知 本项目使用信望爱站（FHL）提供的圣经 API。请注意：圣经翻译版权信望爱网站上的各种圣经翻译仅授权给网站使用。用户必须咨询
版权声明 不得随意使用，以免违反法律。
本项目的作用：此 MCP 服务器仅作为 API 接口层，不存储或重新分发任何经文内容。所有经文内容均即时从 FHL API 获取。
合理使用 本项目是非商业经济研究工具。用户应遵守相关版权法规，并在合理范围内进行研究活动。

开发者责任

：此 MCP 服务器开发者不对用户侵犯版权负责。用户应自行确保其使用符合版权法规。 参考资源
信望爱站主页： https://www.fhl.net/
API 文件： https://bible.fhl.net/api/ （升级版本，包括 bid 字段）
旧版 API： https://bible.fhl.net/json/ （仍可使用）

版权声明

： https://www.fhl.net/main/fhl/fhl8.html 📝 许可证本项目采用 MIT 许可证 - 详情见 LICENSE

归档。

🤝 贡献

欢迎贡献！如果您有任何问题或建议，请打开 Issue 进行讨论。📮 联系如果您有任何问题或建议，请打开

Issue

.
🙏 致谢
感谢信望爱提供丰富的圣经资源 API