用 MCP 5 分钟接入伊斯兰符合股票筛选

dev.to · AI#MCP#集成#Claude

Editor brief · 编辑速览

实战案例展示用 Model Context Protocol 扩展 Claude 能力，快速集成第三方数据源。虽然领域特定，但 MCP 集成思路可推广。

文章思维导图

Knowledge map

拖拽缩放

Full translation

完整中文译文

Model Context Protocol（MCP）允许 AI 客户端直接调用外部工具。连接 Halal Terminal MCP server 后，你的助手就能通过自然语言筛查任意股票或 ETF 是否符合 Shariah 规范，无需再把股票代码复制粘贴到 dashboard 中。本指南将帮助你在大约五分钟内从零完成可用配置。

连接完成后，你可以直接在 Claude Desktop、Claude Code、Cursor 或其他任何 MCP client（Windsurf、Cline、Continue、Zed、Goose）中询问：“AAPL 是 halal 吗？”或者“审核这个投资组合：AAPL、MSFT、GOOGL”。助手会选择合适的工具、调用 API，并根据真实数据回答。

该 server 提供 22 个工具，覆盖八大类别：基于 5 种方法论（AAOIFI、DJIM、FTSE、MSCI、S&P）的股票和 ETF 筛查、批量指数筛查、实时报价和历史价格、ETF 持仓分析、投资组合和 watchlist 扫描、股息和 zakat 计算器、新闻和 SEC 文件，以及报告与教育辅助工具。每项判定都是基于特定方法论的筛查结果，并非 fatwa。

第 1 步：获取免费 API key

在 api.halalterminal.com 注册。只需提供电子邮箱，不需要信用卡，几秒钟后 key 就会发送到你的收件箱。免费套餐每月包含 500 tokens，足够你在升级前充分体验这个 server。你的 key 看起来类似 ht_yourkey。请妥善保存，下一步会用到。

第 2 步：连接客户端

最快的传输方式是托管的 SSE endpoint。对于需要本地桥接的客户端，@halalterminal/mcp package 可以将其封装为 stdio；借助 npx，无需安装：

# Recommended - no install needed
npx -y @halalterminal/mcp

# Or pin globally
npm install -g @halalterminal/mcp

打开 Settings，进入 Developer，编辑配置文件并添加 server。替换成你自己的 key，然后重启 Claude Desktop：

{
  "mcpServers": {
    "halalterminal": {
      "command": "npx",
      "args": ["-y", "@halalterminal/mcp"],
      "env": { "HALALTERMINAL_API_KEY": "ht_yourkey" }
    }
  }
}

在终端执行一条命令，即可通过 SSE 注册托管 server：

claude mcp add --transport sse halalterminal \
  https://mcp.halalterminal.com/sse \
  --header "X-API-Key: ht_yourkey"

Cursor、Windsurf 或任何直接支持 SSE 的客户端

将客户端指向 SSE URL，并通过查询参数传入你的 key：

https://mcp.halalterminal.com/sse?api_key=ht_yourkey

这样就完成了。客户端会自动发现全部 22 个工具。身份验证既可以使用 X-API-Key header，也可以使用 ?api_key= 查询参数，具体取决于你的客户端支持哪种方式。

第 3 步：提出你的第一批问题

像发送普通聊天消息一样输入下面这些问题。助手会将每个问题映射到对应工具，并返回实时结果。

“AAPL 是 halal 吗？”会调用 screen_stock，并并排返回基于 5 种方法论得出的判定结果。在本文发布时进行的实时筛查中，Apple 在全部五种方法论（AAOIFI、DJIM、FTSE、MSCI 和 S&P）下均被判定为合规。判定结果会随财务数据变化，因此应始终以最新结果为准，而不是依赖任何历史快照。

“扫描这个投资组合：AAPL、MSFT、GOOGL”会调用 scan_portfolio，返回每项持仓的判定结果，以及整个投资组合的总体合规比例。

“计算我的持仓应缴纳的 zakat”会调用 calculate_zakat。在你提供持仓信息后，它会根据实时 nisab 门槛，按 2.5% 的比例计算。

“比较 SPUS 和 HLAL”会调用 compare_etfs，按照合规比例、持仓和总体 purification rate 对这两只基金进行并列比较，帮助你判断哪一只更符合自己的标准。

“这只股票的股息 purification 是多少？”会在启用 purification 的情况下调用 get_dividends，计算需要捐出的不合规部分。

由于助手能够读取结构化响应，它也可以串联多个调用：先筛查一只股票，再在同一段对话中获取它近期的新闻和 SEC 文件。

API 按 token 计量，而不是按请求次数计量。典型调用大约消耗 1～5 tokens：一次完整的股票筛查消耗 5 tokens，因此免费套餐提供的 500 tokens 每月大约可以完成 100 次筛查。报价或搜索等轻量读取操作消耗得更少。你可以在 /api/keys/token-costs 查看每个 endpoint 的完整费用表，也可以随时在 dashboard 中查看剩余额度。

使用 Halal Terminal 构建应用

22 个 MCP 工具、5 种筛查方法论、ETF 持仓分析和 zakat 计算器。提供免费套餐，无需信用卡。

获取免费的 API key -> 探索 API

官方 MCP registry：可在 registry.modelcontextprotocol.io 找到该 server。

GitHub repo：github.com/goww7/halalterminal-mcp 提供适用于各类客户端的配置指南、完整工具参考和 issue tracker。

API 文档：交互式参考文档位于 api.halalterminal.com/api-reference。

五分钟后，你的 AI 客户端就能进行 Shariah 筛查了。前往 api.halalterminal.com 获取 key，然后向它提出一个问题。

不构成财务建议。 本页面提供的信息仅用于教育和信息参考，不应被解读为财务建议、投资建议、交易建议或任何其他类型的建议。你不应仅根据此处提供的信息作出任何财务决策。

并非 fatwa。 Shariah 合规筛查结果由自动化数据分析生成，依据的是公开可用的财务数据。这些结果不构成宗教裁决（fatwa），也不应被视为宗教裁决。请务必咨询合格的伊斯兰学者或 Shariah 顾问，以获取针对你自身情况的指导。

请自行研究。 过去的表现和当前的合规状态并不能保证未来的结果或持续合规。筛查数据可能包含错误，也可能已经过时。在作出任何投资决策前，请始终独立核实信息，并咨询合格的财务顾问。

最初发布于 Halal Terminal blog。

如需采取进一步措施，你可以考虑屏蔽此人和/或举报滥用行为。