viewdaily

viewdaily

viewdaily 是一个轻量的本地桥接程序，可连接到 FinChiefs 托管的 MCP 服务。该服务收集来自 200 多家机构的每日研究，包括银行、资产管理公司、中央银行、多边机构和独立研究人员，并将其提炼为资产和宏观主题的方向性观点、每日摘要，以及结构化的央行政策信号；每项内容都附有指向来源发布内容的链接。

该桥接程序不保存任何研究数据。它会在本地提供上游服务的工具列表，内容与从实时端点捕获的完全一致，并将每次工具调用转发到上游，原样返回结果。捕获的全部内容均为只读：这里的任何操作都不会下单、转移资金或向任何地方发送内容。

工具

• list_providers - 服务关注的机构。 可选参数：query（机构名称中的部分内容）和 limit（1-300，默认值为 100）。此处获取的机构 id 可用于将其他工具的查询限制为单一来源。
• list_categories - 资产摘要类别（如 gold、oil、us_bonds、eurusd）和宏观类别 （如 monetary_policy、geopolitics）。标记为支持 每日摘要的键可与 get_daily_digests 配合使用； 宏观键也可用于筛选 search_macro_views 和 summarize_views。无参数。
• summarize_views - 一份简短响应，概览所有 匹配观点：总数、看涨／看跌数量、机构倾向、最活跃的 机构、逐周趋势和讨论最多的主题。 必填参数：kind（asset 或 macro）。可选参数： terms、asset_class、category、provider_id、 since、until。
• search_asset_views - 资产的单条方向性（看涨／看跌） 观点，包含机构、日期、期限、理由和来源链接；通过 offset／next_offset 分页，默认在不同机构间分散结果。
• search_macro_views - 机构研究中的单条宏观主题和 驱动因素，每条均附有描述和来源链接，并采用相同方式分页。
• search_research - 研究出版物（文章、 报告、播客），包含标题、机构、日期、简短描述 和原文链接；按术语匹配度排序，随后按最新时间排序。
• get_daily_digests - 根据所有机构的观点撰写的 指定类别每日摘要，并附当天的看涨／看跌计数。必填参数： categories（1-10 个类别键，例如 ["gold"]； 或使用 ["__overall__"] 获取跨资产摘要）。
• get_policy_signals - 对央行和多边机构出版物的结构化解读： 决策、立场（从 -2 鸽派到 +2 鹰派）、指引、 条件、发言人和预测，按时间从新到旧排列。

配置

• FINCHIEFS_MCP_URL（可选）- 覆盖上游端点。默认值为 https://finchiefs.com/api/mcp。 （此覆盖接口是本次重建自行标注的内容。）
• FINCHIEFS_API_KEY（可选）- 设置后，每个 上游请求都会携带 Authorization: Bearer <key> 标头。未设置时， 不会发送身份验证标头。（此转发机制同样是本次重建自行 标注的内容；原始接口是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 为 2025-03-26，clientInfo name 为 viewdaily），随后发送 notifications/initialized 通知，再发送携带调用方原样参数的 tools/call 请求。当上游 在 initialize 响应中返回 Mcp-Session-Id 标头时， 该值会附加到此会话后续的每个请求中；此会话会在进程运行期间 重复使用。响应可能是纯 JSON，也可能是服务器发送事件； 两种格式都会读取。

成功的上游结果会逐字传回，包括上游设置的任何 isError 标记。失败情况——JSON-RPC 错误、非 2xx 状态、 无法读取的响应或无法完成的请求——会以 isError 结果返回， 其文本以 viewdaily error: 开头（此错误呈现方式是 本次重建自行标注的内容）。

命令行

每个工具也都是一个子命令，接受一个 JSON 参数 字符串（不需要参数的工具可省略）：

npx @reneturcios/viewdaily list_providers '{"query":"ECB"}'
npx @reneturcios/viewdaily summarize_views '{"kind":"asset","terms":["gold"]}'
npx @reneturcios/viewdaily get_daily_digests '{"categories":["gold"]}'
npx @reneturcios/viewdaily list_categories
npx @reneturcios/viewdaily --version

退出代码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/viewdaily mcp

MCP 客户端配置：

{
  "mcpServers": {
    "viewdaily": {
      "command": "npx",
      "args": ["-y", "@reneturcios/viewdaily", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/viewdaily
docker run --rm ghcr.io/cloudcorprecords/viewdaily --version

容器的默认命令为 mcp，因此第一种形式是 stdio MCP 服务；其他参数会照常传递给命令行。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对一个桩化的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT - 参见 LICENSE。