Alfanous MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 该项目实现了一个基于 MCP 的服务器端，负责将 Quranic 搜索、翻译搜索、元数据及 AI 规则等功能暴露为 MCP 工具与资源，供 AI 助手通过 MCP 协议调用。

• 主要功能点

  • 提供 MCP 工具：搜索 Quran 章节/经文、翻译文本、获取信息、建议查询、获取 AI 规则等。
  • 提供 MCP 资源：AI 查询翻译规则文本等可直接获取的文本资源。
  • 通过 MCP 服务器实现 JSON-RPC 风格的请求/响应，便于与各类 LLM 客户端互通。
  • 与 Alfanous 的现有后端能力（Quran 往返搜索、翻译、信息、建议等）对接，形成后端服务。

• 安装步骤

  • 通过 PyPI 安装 MCP 端工作能力的依赖（示例名称：alfanous3-mcp）。
  • 启动命令示例（标准 stdio 模式，便于 Claude Desktop 等客户端集成）：
    • python -m alfanous_mcp.mcp_server

• 服务器配置（客户端使用 MCP 时的配置信息，JSON 格式，包含 server name、command、args 等）

  • server_name: alfANOUS
  • command: python
  • args: ["-m", "alfanous_mcp.mcp_server"] 注：MCP 客户端需要以此信息配置连接的服务器，示例中给出的是可直接使用的启动信息，具体字段含义如下：
  • server_name：服务器在 MCP 客户端的标识名称（如 "alfanous"）。
  • command：启动服务器所使用的命令（如 "python"）。
  • args：启动命令的参数数组（如 ["-m", "alfanous_mcp.mcp_server"]）。 说明：以上配置用于 MCP 客户端连接到该 MCP 服务器，实际使用中客户端无需实现服务器端逻辑，仅需知道服务器的启动指令即可与之通信。

• 基本使用方法

  • 启动服务器：执行提供的启动命令，即可在 stdio 模式下接收来自 MCP 客户端的请求。
  • 客户端交互：通过 MCP 客户端（如 Claude Desktop、Copilot 等）发起对搜索、翻译、信息等工具的调用，请求以 JSON-RPC 形式提交，服务器按 MCP 规范返回响应。
  • 服务器扩展：如需扩展可注册更多工具、资源，或通过 MCP 提供的接口调整能力声明。