FHL Bible MCP Server 📖

A Model Context Protocol (MCP) server for accessing the Faith, Hope, Love (信望愛站) Bible API.

📖 Overview

FHL Bible MCP Server 是一個基於 Model Context Protocol 的伺服器，整合了信望愛站提供的豐富聖經資源 API。透過此 MCP Server，AI 助手（如 Claude）可以直接查詢聖經經文、原文字彙分析、註釋書、主題查經等專業研經資源。

✅ v0.1.2 最新版本 (2025-11-05)
所有已知問題已修復完成（7/7, 100%），包括書卷映射錯誤、Strong's 字典功能增強等。系統功能完整且穩定。
📋 查看完整修復報告 | 📝 更新日誌

✨ 主要功能

• 🔍 經文查詢: 支援多種聖經譯本（和合本、KJV、現代中文譯本等）
• 📚 原文研究: 提供希臘文、希伯來文字彙分析與 Strong's 字典
• 💡 註釋研經: 查詢多種註釋書與牧師講道內容
• 🔎 經文搜尋: 關鍵字搜尋與進階原文編號搜尋
• 🎯 主題查經: 查詢主題相關的聖經教導
• 🎵 有聲聖經: 取得多語言有聲聖經連結
• 🌏 繁簡支援: 完整支援繁體/簡體中文切換

🚀 Quick Start

🎯 方法一：一鍵安裝（推薦）

使用自動化安裝腳本，快速完成環境配置：

# 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 助手配置

📝 方法二：手動安裝

1. 下載專案

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

2. 安裝依賴

   # Windows
   python -m venv venv
   .\venv\Scripts\activate
   pip install -e .
   
   # macOS/Linux
   python3 -m venv venv
   source venv/bin/activate
   pip install -e .
   

3. 配置 AI 助手

   使用自動生成腳本（推薦）：

   python scripts/generate_config.py
   

   或選擇您偏好的 AI 助手手動添加配置：

   Claude Desktop 配置 (推薦) ⭐

   編輯配置文件（%APPDATA%\Claude\claude_desktop_config.json on Windows 或 ~/Library/Application Support/Claude/claude_desktop_config.json on macOS）：

   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！

   GitHub Copilot (VS Code) 配置 💻

   編輯 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"
         }
       }
     }
   }
   

   **ma

... View full README on GitHub