mcpField
T
TrueSource

TrueSource

本地服务
github.com/agentpit-io金融数据5762 周前更新
代码仓库

关于 TrueSource

TrueSource 是 MCP 服务，提供已发生且可溯源的市场信号，包括交易所公告、政府采购中标、研发扩张、北向持仓和官方宏观数据。面向需要可引用依据的 AI Agent 用户。项目不汇总分析师报告，也不输出买卖建议。

主要功能

  1. 01政府采购中标记录查询
  2. 02宏观数据发布查询
  3. 03按股票批量生成信号摘要与提醒级别
  4. 04仅返回越过阈值的提醒信号
  5. 05对 35 个预置算力标的生成完整报告
  6. 06对任意 A 股实时采集信息

适用场景

  1. 01查询近期政府采购中标情况以核实公司业务进展
  2. 02批量监控自选股的提醒信号
  3. 03为研究报告提供带日期和来源的依据

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露采购、宏观、每日摘要、提醒信号、报告和实时采集等工具。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "hangeaiagent-truesource": {
      "command": "uvx",
      "args": [
        "truesource-mcp"
      ],
      "env": {
        "HUNTER_API_KEY": "<HUNTER_API_KEY>",
        "TRUESOURCE_URL": "<TRUESOURCE_URL>",
        "TRUESOURCE_MAX_ITEMS": "<TRUESOURCE_MAX_ITEMS>"
      }
    }
  }
}
启动命令uvx truesource-mcp
需要配置的环境变量
HUNTER_API_KEY密钥API key from https://hunter.agentpit.io/dev/api-keys
TRUESOURCE_URLOverride the upstream endpoint if you self-host
TRUESOURCE_MAX_ITEMSCap on items per response

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

安装包
pypitruesource-mcp0.1.1

工具

6

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

参数类型必填说明
daysinteger否
limitinteger否

详细介绍

truesource-mcp

AI Agent 可以实际引用的一手市场信号。

一个封装了 TrueSource 的 MCP 服务——TrueSource 是一套爬取和 AI 检索技术栈，用于监测已经发生且有可验证来源的事项：交易所公告、政府采购中标、研发扩张动向、北向持仓，以及官方宏观数据发布。

它不会总结分析师报告，也不会给出买入／卖出建议。每条信号都附有日期和来源。

许可证

工具

工具功能速度
truesource_procurement(days, limit)近期政府采购中标信息——实际赢得合同的对象快
truesource_macro(days)统计部门、海关和行业机构发布的宏观数据快
truesource_daily_brief(symbols)一批股票代码的信号摘要＋警报级别（最近 3 天）快
truesource_alert_signals(symbols)仅包含突破警报阈值的信号（最近 26 小时）快
truesource_report(symbol)完整研究报告——仅限 35 个预先构建的 AI 算力标的快
truesource_scout(symbol, name)为任意 A 股实时完整收集信息30–60 秒

采购信息是最具特色的功能：合同中标是已经发生的事实，比预测更可靠。

快速开始

你需要先获取 API 密钥——请参阅下文。

Claude Desktop / Cursor

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "truesource": {
      "command": "uvx",
      "args": ["truesource-mcp"],
      "env": { "HUNTER_API_KEY": "hunt_tools_xxx" }
    }
  }
}
命令行
# no install needed
HUNTER_API_KEY=hunt_tools_xxx uvx truesource-mcp

# or install it
pip install truesource-mcp
HUNTER_API_KEY=hunt_tools_xxx truesource-mcp

API 密钥

此服务不支持无密钥模式，也无法支持——上游网关在未提供密钥时会返回 403。

原因在于成本：每次调用 truesource_scout 都会运行实际爬虫并执行 Gemini 搜索，因此每次调用都会产生第三方 API 费用。匿名访问很容易被滥用，成本高昂，而且无法追踪来源。

前往 https://hunter.agentpit.io/dev/api-keys 获取密钥——登录后，点击 申请 API Key，复制 hunt_tools_… 密钥（仅显示一次），并将其设为 HUNTER_API_KEY。

如果缺少密钥，此服务不会返回示例数据或伪造成功结果，而是会返回一条错误信息，明确告知你如何获取密钥。

环境变量

变量默认值说明
HUNTER_API_KEY—必填。 hunt_tools_ 密钥
TRUESOURCE_URLhttps://hunter.agentpit.io/api/saas/truesource自托管时，指向你自己的部署
TRUESOURCE_TIMEOUT20秒。scout 的超时下限始终为 120 秒
TRUESOURCE_MAX_ITEMS40每次响应的条目数上限
TRUESOURCE_MCP_TRANSPORTstdiostdio | streamable-http | sse
TRUESOURCE_MCP_HOST / _PORT0.0.0.0 / 8933仅适用于远程传输

Claude Desktop、Cursor 和 uvx 使用 stdio。只有在需要由一个长期运行的服务为多个客户端提供服务时，才运行远程传输；并且优先使用 streamable-http，因为 MCP 规范已将 SSE 标记为弃用。

否则可能会踩的三个坑

grey 不等于 green。 在 daily_brief 中，警报级别为 grey 表示 最近 3 天内未收集到该股票代码的信号。这可能意味着该股票表现平静，也可能意味着监测遗漏了它。这不代表“安全”。

空结果是一种结论，而非失败。 alert_signals 未返回任何内容，表示这些股票代码在过去 26 小时内均未触及任何阈值。这本身就是信息。此服务绝不会把空结果伪装成错误，也不会用占位行填充结果。

截断情况始终会明确说明。 响应最多包含 TRUESOURCE_MAX_ITEMS（默认为 40）项。达到上限时，负载会包含 truncated: true、实际的 total，以及请勿根据当前可见部分得出结论的说明。请提高上限，或缩小日期范围。

如果股票代码不在 35 个预构建名称中，truesource_report 也不会悄悄回退到 scout。Scout 需要 30–60 秒并会产生实际费用——应当有意做出这个选择，而不是让它在你不知情时发生。

你可能遇到的错误

错误含义
missing_api_key未设置 HUNTER_API_KEY——请参阅 API 密钥
invalid_api_key (401)密钥错误、不完整或已撤销
forbidden (403)密钥有效，但无权访问此端点
not_found (404)对于 report：股票代码不是预构建名称——请使用 truesource_scout
timeoutscout 实际需要 30–60 秒；请提高 TRUESOURCE_TIMEOUT
upstream_down (502/503)爬虫服务不可用；请稍后重试

相关项目

  • kronos-mcp — A 股、美国和香港股票的 K 线预测
  • akshare-mcp — 让模型自行探索 AKShare 的 1000 多个中国市场数据函数
  • hunter-community — 这些项目所基于的开源技术栈

Apache-2.0。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。