关于 Halal Terminal
Halal Terminal 是面向伊斯兰金融研究的 MCP 服务，供 AI Agent 按五种教法合规方法筛选股票和 ETF、审查投资组合，并计算天课与股息净化额。它还提供市场数据、新闻和 SEC 文件。
主要功能
- 01按五种方法筛选股票和 ETF
- 02批量筛选指数并审计投资组合
- 03计算天课与股息净化额
- 04查询报价、历史价格、新闻和 SEC 文件
- 05比较股票、ETF 和投资组合
适用场景
- 01比较某只股票在不同方法下的判定
- 02筛选 ETF 持仓并查看净化率
- 03审查投资组合持仓的教法合规性
- 04计算天课或股息净化额
MCP 相关
通过托管 SSE 端点或 stdio 桥接程序提供 22 种工具，涵盖筛选、财务计算、市场数据、新闻和文件查询。它可连接 Claude Desktop、Cursor 和 Continue 等 MCP 客户端。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://mcp.halalterminal.com/sseclaude mcp add --transport sse com-halalterminal https://mcp.halalterminal.com/sse{"mcpServers":{"com-halalterminal":{"type":"sse","url":"https://mcp.halalterminal.com/sse"}}}在 Cursor 中打开{"servers":{"com-halalterminal":{"type":"sse","url":"https://mcp.halalterminal.com/sse"}}}在 VS Code 中打开{"mcpServers":{"com-halalterminal":{"type":"sse","url":"https://mcp.halalterminal.com/sse"}}}{"mcpServers":{"com-halalterminal":{"serverUrl":"https://mcp.halalterminal.com/sse"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.halalterminal.com/sse需要授权工具
详细介绍
Halal Terminal MCP — 面向 AI Agent 的符合伊斯兰教法的股票与 ETF 筛选
English | العربية | Bahasa Indonesia | Melayu | اردو | Français
来自 API 的实时徽章，可为任意代码嵌入徽章
这是 Halal Terminal 的官方 Model Context Protocol 服务。为你的 AI Agent 提供 22 种工具，用于回答伊斯兰金融相关问题：按照 5 种方法（AAOIFI、DJIM、FTSE、MSCI、S&P）筛选任意股票或 ETF、审查投资组合、计算 天课和股息净化额，并获取实时市场数据、新闻和 SEC 文件。可在 Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Continue、Zed、Goose 以及任何其他 MCP 客户端中使用。
“AAPL 符合伊斯兰教法吗？” · “审查我的投资组合：AAPL 30%、MSFT 20%、JNJ 50%” · “计算我持仓的天课。”
快速开始
- 获取免费 API 密钥 — 在 api.halalterminal.com 注册，只需提供邮箱。无需信用卡。密钥将在几秒钟内发送到你的收件箱。
- 连接客户端 — 使用下方的一行配置（或者查看 CONNECT.md，了解 Cursor、Windsurf、Cline 等客户端的配置方法）。
- 提出你的第一个问题 —
"Is AAPL halal?"→ Agent 会调用screen_stock，并返回所有 5 种方法的判定结果。
安装
# Recommended — no install needed
npx -y @halalterminal/mcp
# Or pin globally
npm install -g @halalterminal/mcp
Claude Desktop
{
"mcpServers": {
"halalterminal": {
"command": "npx",
"args": ["-y", "@halalterminal/mcp"],
"env": { "HALALTERMINAL_API_KEY": "ht_yourkey" }
}
}
}
Claude Code
claude mcp add --transport sse halalterminal \
https://mcp.halalterminal.com/sse \
--header "X-API-Key: ht_yourkey"
Cursor / Windsurf / 直接使用 SSE
https://mcp.halalterminal.com/sse?api_key=ht_yourkey
所有客户端的完整配置指南：CONNECT.md。
你将获得什么 — 8 个类别中的 22 种工具
| 类别 | 工具 |
|---|---|
| 筛选 | screen_stock、screen_etf、bulk_screen、get_screening_result、get_all_screening_results |
| 市场数据 | get_quote、get_stock_info、get_price_history、get_trending_stocks、search_stocks |
| ETF 分析 | get_etf_info、etf_purification、compare_etfs |
| 投资组合与关注列表 | scan_portfolio、manage_watchlist |
| 比较 | compare_stocks |
| 收入与天课 | get_dividends、calculate_zakat |
| 新闻与文件 | get_news、get_sec_filings |
| 报告与教育 | generate_report、islamic_finance_education |
完整的输入/输出参考见 TOOLS.md。端到端提示词演练见 EXAMPLES.md。
为什么选择 Halal Terminal
- 5 种方法，一种工具。 AAOIFI、DJIM、FTSE Shariah、MSCI Islamic 和 S&P Shariah 各有不同的业务活动规则和财务比率阈值。系统会并列展示每只股票的筛选结果，方便用户选择自己遵循的标准。
- 按持仓筛选 ETF。 对每项成分持仓进行筛选、加权和汇总，得出总体判定结果以及每美元的净化率。涵盖 SPY、QQQ、VTI、ISDU、SPUS、HLAL 和 8,000 多只 ETF。
- 计算天课与净化额。 按实时 nisab 门槛计算 2.5% 的天课；根据发行方不合规收入占比，计算每笔股息中的不纯收入。
- 批量筛选指数。 可对 S&P 500、NASDAQ-100、FTSE 100 等指数启动筛选并轮询结果；可按方法、行业或仅符合标准的股票进行筛选。
- 免费套餐，无需信用卡。 使用邮箱注册 → 几秒钟内收到密钥 → 每月可免费进行约 5–10 次完整筛选。
端点与传输
SSE: https://mcp.halalterminal.com/sse
Auth: X-API-Key: <your_key> (or ?api_key=<your_key>)
支持的传输方式：SSE（推荐）、stdio（通过 @halalterminal/mcp 桥接服务，供需要此方式的客户端使用）。
计划与配额
Halal Terminal API 按令牌计量，而非按请求计量。
| 计划 | 每月令牌数 | 价格 | 备注 |
|---|---|---|---|
| 免费版 | 50 | $0 | 约 5–10 次完整筛查 · 使用电子邮件注册，无需信用卡 |
| 入门版 | 2,500 | $19 | 个人投资者 |
| 专业版 | 15,000 | $49 | Webhook、批量处理优先 |
| 企业版 | 不限量 | $199+ | 自定义方法、SLA |
注册：api.halalterminal.com · 价格：halalterminal.com/pricing
此 MCP 服务不是什么
- 不是教法裁决。 每项判定都是基于方法的筛查结果。个人裁决请咨询合格的学者。
- 不是交易平台。 不集成经纪商，也不执行订单。
- 不是实时提醒系统。 v1 仅支持请求-响应；由 Webhook 驱动的提醒已列入 Pro+ 路线图。
- v1 仅支持英语。 阿拉伯语和法语呈现已列入路线图。
常见问题
这个 MCP 服务可以免费使用吗？
可以。@halalterminal/mcp 软件包采用 Apache-2.0 许可证，且免费。Halal Terminal API 提供免费套餐（每月 500 个令牌，无需信用卡），可进行约 100 次完整股票筛查——足以让你在升级前进行评估。
它适用于哪些 AI 客户端？
任何支持通过 SSE 或 stdio 使用 Model Context Protocol 的客户端都可以——包括 Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Continue、Zed、Goose 等。推荐使用 SSE；对于尚不支持 SSE 的客户端，@halalterminal/mcp 软件包会将其封装为 stdio。
如何判定“清真”？
每项判定都依据所选方法公布的规则——AAOIFI、Dow Jones Islamic Market (DJIM)、FTSE Shariah、MSCI Islamic 和 S&P Shariah。分为两个层面：(1) 业务活动筛查（不涉及酒精、赌博、传统金融、成人内容、武器、猪肉等），然后是 (2) 财务比率阈值（例如，有息债务占市值的比例、非流动资产、利息收入占比）。MCP 会提供全部五种判定，供用户或学者选择自己遵循的标准。
什么是股息净化？
如果你持有的股票有少量收入来自不合规业务，学者要求将收到的任何股息中相应的不合规部分捐赠出去。calculate_zakat(calculation_type="purification", …) 和 get_dividends(include_purification=True) 会自动计算该金额。
可以筛查 ETF 吗？
可以——screen_etf 会遍历所有底层持仓，逐一应用筛查方法，并返回总体判定、合规比例和汇总净化率。Sukuk ETF 会单独处理（采用资产型方法）。
可以一次筛查整个指数吗？
可以——bulk_screen 可对 S&P 500、NASDAQ-100、FTSE 100 等指数启动异步运行；你可以轮询状态，按方法／行业／仅合规项筛选结果，并比较两次运行的差异。
是否支持在合规状态变化时使用 Webhook？
Webhook 是 API 路线图中的 Pro 计划功能；此 MCP 的 v1 仅支持请求-响应。
在哪里报告 Bug 或申请工具？
github.com/goww7/halalterminal-mcp/issues 或发送电子邮件至 [email protected]。
了解更多
Halal Terminal 生态系统的一部分
网站 · API · Python SDK · JS SDK · Claude 插件 · Discord 机器人 · TradingView 指标 · 投资组合跟踪器
相关项目（同系列开源项目）
使用相同 Halal Terminal API 的开源工具——应用场景不同，数据相同：
| 项目 | 简介 | 许可证 |
|---|---|---|
| halalterminal-claude-skills | Claude Code 插件——基于此 MCP 服务提供精选技能、斜杠命令和投资组合构建子 Agent。 | Apache-2.0 |
| yassir-oss | 用于清真金融研究的开源 ReAct Agent——命令行 + Web UI；支持 OpenAI / Anthropic / 本地大模型。 | Apache-2.0 |
| halal-discord-bot | Discord 机器人——提供 /halal AAPL、/portfolio、/trending 斜杠命令。 | MIT |
| halal-portfolio-tracker | Next.js 14 应用——输入持仓，即可查看每只股票的合规情况、投资组合的清真比例和应缴净化金额。一键部署到 Vercel。 | MIT |
| halal-pine | TradingView Pine Script v5 指标，可在图表上叠加显示合规状态。每天从此 API 刷新数据。 | MIT |
许可证与商标
Apache-2.0——详见 LICENSE。
“Halal Terminal”、“HalalTerminal”和 Halal Terminal 徽标均为保留商标——详见 TRADEMARKS.md。
法律信息
支持
- 联系方式：[email protected]
- 控制面板：api.halalterminal.com/dashboard
- API 文档：api.halalterminal.com/docs（Swagger） · api.halalterminal.com/redoc（ReDoc）
由 Halal Terminal 提供支持 — halalterminal.com
属于 Halal Terminal 开放生态系统： API · MCP 服务 · Python SDK · JS SDK · 数据集 · Awesome Islamic Finance
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。