Fanar

Name: Fanar
Author: Blade-Labs

本地服务

github.com/Blade-LabsAI 与智能体01 周前更新

代码仓库

关于 Fanar

Fanar 是连接 QCRI 阿拉伯语生成式 AI 平台的 MCP 服务，最初面向伊斯兰金融领域。它提供带引文的伊斯兰问答、引文核验、研究、翻译、语音和图像工具。

主要功能

01带来源的伊斯兰问答
02核验《古兰经》和圣训引文
03研究及阿拉伯语—英语翻译
04阿拉伯语和英语语音工具
05图像生成与内容审核

适用场景

01查找教法问题的参考答案
02发布前核验宗教引文
03翻译古典阿拉伯语文本
04转录或生成阿拉伯语语音

MCP 相关

该服务向 MCP 客户端开放 Fanar 模型和工具，包括聊天、伊斯兰问答、引文核验、研究、翻译、语音、图像生成和内容审核。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "blade-labs-fanar": {
      "command": "uvx",
      "args": [
        "fanar-mcp"
      ],
      "env": {
        "FANAR_API_KEY": "<FANAR_API_KEY>"
      }
    }
  }
}

启动命令uvx fanar-mcp

需要配置的环境变量

FANAR_API_KEY密钥Your Fanar API key, requested at https://api.fanar.qa/request

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypifanar-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

fanar-mcp

一个用于 Fanar 的模型上下文协议服务。Fanar 是由哈马德·本·哈利法大学旗下的 QCRI 打造、以阿拉伯语为核心的生成式 AI 平台。它为任何 MCP 客户端（Claude Desktop、Claude Code、Cursor 和其他 Agent 框架）提供 Fanar 的聊天模型、附带引文的伊斯兰问题解答、古兰经和圣训引文核查、深度研究、阿拉伯语与英语互译、阿拉伯语双向语音处理，以及图像生成。

首先面向伊斯兰金融社群打造：提出教法问题并获取来源，在发布前检查草稿中的每条引文，以及翻译古典阿拉伯语文本。

Blade Labs 的独立开源项目。与 QCRI 或 HBKU 无关，也未获其认可。状态：alpha。

工具

工具	功能	Fanar 模型	每个密钥的默认限额
`fanar_list_models`	列出你的密钥可调用的模型。请从这里开始：不同密钥的权限各不相同
`fanar_chat`	使用阿拉伯语（现代标准语及方言）或英语聊天，可选择逐步思考	Fanar-C-2-27B, Fanar	每分钟 50 次
`fanar_islamic_qa`	提供带参考资料的伊斯兰问题解答；Sadiq-2 支持教法学派和来源筛选	Fanar-Sadiq, Fanar-Sadiq-2	每分钟 50 次
`fanar_validate_quotations`	查找并核实文本中的古兰经和圣训引文	Fanar-Sadiq-2	每分钟 200 次
`fanar_deep_research`, `fanar_deep_research_result`	针对伊斯兰主题生成结构化、附引文的研究报告（耗时数分钟）	Fanar-Sadiq-2	每天 20 次
`fanar_translate`	阿拉伯语与英语互译，包括古典文本	Fanar-3.0-Shaheen-Translate	每天 20 次
`fanar_text_to_speech`	使用十种语音将阿拉伯语或英语转换为语音；Sadiq-TTS 支持古兰经诵读者的语音	Fanar-Aura-TTS-2	每天 20 次
`fanar_transcribe`	将阿拉伯语（含方言）或英语语音转为文本；支持长音频选项	Fanar-Aura-STT-1, STT-LF-1	每天 20 次，长音频 10 次
`fanar_generate_image`	具有文化意识的图像生成	Fanar-Oryx-IG-2	每天 20 次
`fanar_moderate`	为提示词和回答提供安全性与文化意识评分	Fanar-Guard-2	每分钟 50 次
`fanar_poem`	创作古典风格的阿拉伯诗歌	Fanar-Diwan	每分钟 50 次

限额采用 Fanar 公布的默认值；每个结果都会显示 Fanar 报告的剩余配额。如果工具需要的模型不在你的密钥权限范围内，则会返回清晰的错误，并附上申请访问权限的链接。

提示词：islamic_finance_question（提供含来源的回答并核查引文）和 verify_islamic_quotations（发布前检查文本）。

获取密钥

请通过 https://api.fanar.qa/request 申请 API 访问权限。Fanar 会在密钥 90 天未使用后将其停用。

安装和配置

需要 Python 3.10 或更高版本。

pip install fanar-mcp          # or run it without installing: uvx fanar-mcp
uvx --from git+https://github.com/Blade-Labs/fanar-mcp fanar-mcp   # straight from GitHub

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "fanar": {
      "command": "uvx",
      "args": ["fanar-mcp"],
      "env": { "FANAR_API_KEY": "your-key" }
    }
  }
}

Claude Code：

claude mcp add fanar -e FANAR_API_KEY=your-key -- uvx fanar-mcp

Cursor 和其他客户端使用相同的命令（uvx fanar-mcp）和 FANAR_API_KEY 变量。如需共享服务，请运行 fanar-mcp --transport streamable-http --port 8765。

环境变量：FANAR_API_KEY（必需）、FANAR_BASE_URL（默认值为 https://api.fanar.qa/v1）、 FANAR_MCP_OUTPUT_DIR（音频和图像的保存位置；默认值为 ~/fanar-mcp-output）。

负责任地使用

fanar_islamic_qa 的回答附有引文，但不是教法裁决。请展示参考资料，说明各教法学派之间的差异，并将具有约束力的问题交由合格学者或教法委员会处理。
fanar_validate_quotations 未标记的引文并未经过核实。请将其视为未经核实。
你对 API 的使用受 Fanar 自身条款约束。在商业产品中使用 Fanar 前，请阅读相关条款。
此服务绝不会记录或返回你的 API 密钥。

开发

pip install -e ".[test]"
pytest                        # offline tests, no network or key needed
FANAR_API_KEY=... python scripts/smoke.py   # live check through a real MCP client