Chain of Thought podcast archive

Chain of Thought 播客档案 MCP 服务

这个只读的模型上下文协议服务可让 AI Agent 和编码助手搜索 Chain of Thought 的文字稿和单集元数据，并引用单集页面。该播客由 Conor Bronsdon 主持。无需登录或 API 密钥。它作为 Cloudflare Worker 运行，并使用 D1 全文搜索。

端点

https://mcp.chainofthought.show/mcp 已上线。传输方式为无状态 Streamable HTTP。GET / 会介绍该服务，GET /health 会返回 ok。

工具

工具	输入	返回内容
search_transcripts	query（最多 200 个字符）、limit（1–20，默认为 8）、可选的 episode（1–9999）	按排名排列的段落，包含单集、嘉宾、发言者、时间戳、摘要、片段 URL 和引用。
search_episodes	query（最多 200 个字符）、limit（1–20，默认为 8）	按排名排列的单集，包含日期、嘉宾、摘要、匹配章节、URL 和引用。
get_episode	episode（1–9999）或 slug（最多 300 个字符，可包含完整单集 URL）	元数据、嘉宾、章节，以及单集、YouTube 和音频链接。
get_transcript_excerpt	episode（1–9999）、可选的 at（搜索结果中的 segment_index、段落 URL 或其 #t- 锚点、m:ss 或 h:mm:ss）、before（0–5，默认为 2）、after（0–10，默认为 5）	最多 16 个连续片段，各自附有 URL，并提供锚点和分页标记。

搜索结果的排名方式

文字稿搜索会使用 BM25 对段落进行排名，并提高单集标题、嘉宾、章节标题或摘要与查询匹配的段落的排名。包含所有查询词的段落会排在只包含部分查询词的段落之前。几乎相同的段落（例如在多集节目中重复出现的赞助商口播）会合并为一条结果。

search_transcripts 结果的结构如下（文本值已缩略）：

{
  "episode": 77,
  "episode_title": "…",
  "guests": ["…"],
  "published_at": "…",
  "speaker": "…",
  "time": "…",
  "seconds": 29,
  "segment_index": 2,
  "snippet": "…",
  "match": "all_terms",
  "url": "https://chainofthought.show/podcast/…/#t-2",
  "episode_url": "https://chainofthought.show/podcast/…/",
  "cite": "Chain of Thought, chainofthought.show — https://chainofthought.show/podcast/…/#t-2"
}

连接

以下步骤依据各供应商截至 2026-10-14 的文档。部署端点后，客户端才能连接。

Claude Code

在 Claude Code 中安装

在 Claude Code 会话中，将此仓库添加为插件市场并安装该插件：

/plugin marketplace add conorbronsdon/chain-of-thought-podcast-mcp
/plugin install chain-of-thought-podcast@chain-of-thought-podcast-mcp

该插件无需 API 密钥，即可连接到公开的远程 MCP 端点。它的可选 /chain-of-thought-podcast:cite-chain-of-thought 技能可帮助查找和引用播客讨论内容。

直接添加 MCP 服务

运行 Claude Code MCP 命令：

claude mcp add --transport http chain-of-thought https://mcp.chainofthought.show/mcp

默认使用本地作用域。--scope project 会写入 .mcp.json；项目配置项如下：

{"mcpServers":{"chain-of-thought":{"type":"http","url":"https://mcp.chainofthought.show/mcp"}}}

--scope user 会让它在所有项目中均可使用。

Claude 应用自定义连接器

在 Claude 的连接器设置中，打开 Customize > Connectors > + Add > Add custom connector。输入 chain-of-thought 和 https://mcp.chainofthought.show/mcp，选择 Continue，在 Authentication 下选择 No sign in，然后选择 Add。免费计划最多可添加一个自定义连接器。Team 计划仅允许 Owners 和 Primary Owners 添加连接器；Enterprise 计划中，Owners、Primary Owners 以及拥有 Manage access to Libraries 权限的角色可以添加连接器。

Cursor

按照 Cursor MCP 文档中的说明，将以下内容添加到项目的 .cursor/mcp.json 或全局的 ~/.cursor/mcp.json：

{"mcpServers":{"chain-of-thought":{"url":"https://mcp.chainofthought.show/mcp"}}}

ChatGPT

打开 ChatGPT 插件，选择加号按钮，然后选择 Add custom MCP server。输入 chain-of-thought 和描述。在 Connection 下，输入 https://mcp.chainofthought.show/mcp。配置身份验证（此服务不需要身份验证），查看风险警告，选择 I understand and want to continue，然后选择 Create as a plugin，并查看已发现的工具。必须使用公开的 HTTPS 端点；账户和工作区政策也可能适用。请参阅 OpenAI 连接指南。

OpenAI 插件 ZIP

使用 npm run package:openai 构建供 ChatGPT/Codex 上传的文件。有关验证、品牌来源、ZIP 内容和提交步骤，请参阅 OPENAI_PLUGIN.md。

引用和使用条款

源语料库声明：

署名：“Chain of Thought — chainofthought.show”

规范链接：“每条记录都带有 canonicalUrl。请引用该页面，而不是此端点：该页面是权威呈现，也是会得到更正的页面。”

转录文本：“由机器（ASR）生成，并在同步期间进行了实体更正。转录文本可能包含错误；引用前请对照录音核实。”

许可：“CC-BY-4.0”

音频：“节目音频和视频不在许可范围内：保留所有权利。音频和视频 URL 仅供链接使用；请链接到节目页面，而不是复制媒体。”

再分发：“转录文本和节目元数据采用 CC BY 4.0 许可，并作为数据集发布于 https://huggingface.co/datasets/conorbronsdon/chain-of-thought-podcast-transcripts。请注明 Chain of Thought (chainofthought.show)，并链接到节目页面。”

url 是引用页面；对于转录文本片段，它包含一个用于打开该片段的 #t- 锚点。锚点可能包含一个或两个数字，并且与 segment_index 分开。将完整 URL 或其锚点传递给 get_transcript_excerpt，即可检索该片段。episode_url 是不带片段锚点的节目页面。cite 按 Chain of Thought, chainofthought.show — <url> 格式组合署名和 url。

限制和更新时效

查询长度限制为 200 个字符。搜索返回 1–20 条结果（默认 8 条）。摘要约为 600 个字符；片段最多 1,500 个字符，每段摘录最多包含 16 个片段。没有任何工具会返回完整转录文本。早期第 5、6、7 和 9 集中的部分片段没有时间戳：time 和 seconds 为 null，但其 URL 仍然有效。

每小时运行的 cron 每次最多添加、更改或删除一集；如果没有积压，新发布的节目通常会在 corpus.json 中出现后约一小时内完成索引。成功的工具结果会缓存一小时；因此，重复搜索可能会在长达约一小时的时间内返回摄取前的结果。转录文本更正会在轮询检查轮到相应节目时获取；每小时检查一集，检查全部 77 集约需 3.2 天。日志会记录工具名称、成功状态、结果数量和耗时，不会记录查询文本。

开发

使用 Node 22.18 或更高版本：

npm ci
npm test
npm run typecheck

对于包含三集的测试夹具，请按顺序运行以下命令，并在集成测试期间保持 dev:fixture 运行：

npm run build-sql:fixture
npm run db:fixture
npm run dev:fixture
MCP_URL=http://127.0.0.1:8787/mcp npm run test:integration

对于完整语料库：

npm run build-sql
npm run db:full
npm run dev:full
npm run query -- --top 3 --compact search_transcripts '{"query":"..."}'
npm run eval

要在本地测试 cron，请启动 wrangler dev --test-scheduled 并调用：

curl "http://127.0.0.1:8787/__scheduled?cron=23+*+*+*+*"

dist/ 和 .cache/ 存放转录文本，并已加入 gitignore。请勿提交或发布它们。请参阅部署和设计说明。

许可

本仓库中的代码采用 MIT 许可；请参阅 LICENSE。该许可不涵盖 chainofthought.show 提供的播客转录文本、节目元数据或其他内容；本服务会在运行时读取这些内容。上述使用条款适用于这些内容。