Chart Library — Market-state research

Chart Library MCP

面向 AI 的市场记忆，为 Agent 和用户提供已发布的研究。

版本 6.3.3 会将失败的公开工具调用标记为 MCP 错误，同时保留其结构化恢复详情。无效请求会说明如何修正输入；过期的发布版本会保留从当前概览重新开始的说明。 成功响应的架构和直接 Python 调用保持兼容。

五种只读工具

工具	输入	结果
market_state	标的；可选日期	已完成交易时段的状态、历史相似案例、结果范围、状态转换记忆和行情带
daily_note	可选日期	已发布的每日研究、筛选规则和已结算笔记统计
research_quality	无	已发布的校准凭证、带日期的样本和资格说明
search_research	查询；可选类型、数量上限和偏移量	相关出版物、ID、发现、样本凭证、限制和版本
read_research	研究 ID；可选章节、偏移量和版本	概览或精确的源文档，附带分页信息和哈希

市场状态请求无需预先搜索或提供群组句柄。对于已发布的研究，先搜索 ID，再读取其证据。

示例问题：“读取 AAPL 最近一个已完成交易时段的状态。报告历史相似案例范围、样本量、交易时段日期和限制。”

省略日期时，使用最新构建/发布的交易时段，而非实时行情。日期格式为 YYYY-MM-DD。缺失或稀少的证据仍会标记为缺失或稀少。

连接

主要远程端点为 **https://chartlibrary.io/mcp**，使用 Streamable HTTP，无需身份验证。

对于基于命令的客户端，请安装或升级软件包：

python -m pip install --upgrade chartlibrary-mcp

然后在 MCP 客户端中使用等效配置：

{
  "mcpServers": {
    "chartlibrary": {
      "command": "chartlibrary-mcp"
    }
  }
}

无需 API 密钥或服务端 Python 软件包。设置可选的 CHART_LIBRARY_API_KEY 后，该密钥会作为 Bearer 令牌转发。密钥为空时， 不会发送 Authorization 标头。CHART_LIBRARY_API_URL 可用于选择你自己的 兼容端点；只有在信任该端点能够安全处理此密钥时，才将其指向该端点。

需要 Python 3.10+。此版本使用 MCP 1.x FastMCP 接口，并将版本固定为 mcp>=1.28.1,<2.0.0；MCP 2.x 需要单独迁移。

等效的 HTTP 调用

curl "https://chartlibrary.io/api/v1/state-packet?symbol=AAPL"
curl "https://chartlibrary.io/api/v1/daily"
curl "https://chartlibrary.io/api/v1/calibration"

只使用与问题相关的调用。查询历史状态时，添加 &date=YYYY-MM-DD。每日 REST 请求将日期参数称为 session。

研究工作流

search_research(query="IONQ noon", kind="casebook")
read_research(research_id="casebook:ionq-noon", section="article",
              version="FULL_VERSION_FROM_SEARCH")

将 FULL_VERSION_FROM_SEARCH 替换为所选搜索结果中的完整 64 字符版本号。更新后的服务会直接提供 documents[section].read_arguments； 将其复制到工具中，并按照 content.next_read 继续读取，直到其值为 null。对于较早版本的服务，请显式传入返回的版本和 next_offset。省略可选的 version 时，会读取当前出版物，但不会将其与较早的响应进行版本核对。 版本变更时会返回错误，说明如何从当前概览重新开始；客户端不会自动重试。

搜索摘要是用于发现内容的元数据，而非源文档。作出结论前，请阅读可用指南和相关的限制性发现。关键词搜索会按文档相关性排序，而非市场相似度或证据强度。部分结果表示某个出版物源不可用。 已撤回的文章无法读取。出版日期与市场截点并不相同；不得将 IONQ 的正午案例与已完成交易时段状态的相似案例合并。

完整的 IONQ 示例 · Agent 研究计划

准确解读证据

• 保留日期、样本量、信息性收据、警告和来源信息。
• 状态数据包超额收益是相对于日期匹配的流动性股票基准的百分点观测值。每个期限都有各自的观测样本量 n。
• 原始历史百分位数并不自动等同于经过校准的预测。
• research_quality 仅审计其收据所指明的方法和总体。请勿将其覆盖率转用于每种市场状态或全部研究。
• 每日研究有自己的筛选规则和已结算笔记统计。
• 历史频率不是买入或卖出建议。

研究访问免费。服务限制和底层数据条款仍然适用。 请遵守 HTTP 429 响应和重试指引；不要假设吞吐量不受限制。

现有集成

现有工具名称仍保持注册且可调用，包括 pull_comps、 search、state_packet 和队列检查工具。若要在本地客户端中发现扩展菜单，请设置 CHART_LIBRARY_MCP_PROFILE=advanced。 这只会更改发现内容，不会改变授权或对私有研究的访问权限。

公共菜单不会公开私募基金运营或所有实验性的状态记忆方法。examples/ 中的旧版示例使用高级接口。

与我们共建

如需定制集成、开展更大规模的研究，或基于该记忆构建产品，请联系 Graham McCain — [email protected]。

开发者指南 · 方法论 · 数据条款 · 隐私

本地验证

python -m pytest test_vendor_import.py

导入冒烟测试无需 API 密钥，也无需应用程序的 services/ 或 db/ 包。测试不会发布任何包或注册表内容。