runitonai-mcp

Run It on AI — 完整公开的配套服务

此仓库包含为 mcp.runitonai.com 上的 Run It on AI 阅读伴侣提供支持的服务的完整源代码。如果你购买了本书并将 AI 连接到它，这里就是我们这边运行的全部内容。

我们公开这些代码，是为了让你不必盲目信任我们。这个服务只有几百行 TypeScript。你（或你的 AI——粘贴任意文件并提问）可以准确地了解它会做什么，同样重要的是，也可以了解它不能做什么。

简介

使用阅读伴侣时，哪些信息会到达我们的服务：

• 你的 AI 调用的工具名称（例如“获取第 3 章”）。
• 它请求的章节或练习。
• 你的访问码——印在 Gumroad 收据上的许可证密钥。

哪些信息永远不会传到我们这里，因为这里没有任何代码可以接收、存储或转发这些信息：

• 你与 AI 的对话。
• 你的文件、文档或你设备上的任何内容。
• 你的姓名。
• 你的电子邮箱。在此仓库中搜索电子邮箱字段：没有。没有任何工具、端点或代码路径会接收此类信息。
• AI 在你工作时对你形成的印象。这些信息会留在你的 AI 内部，保留在你这边。

**谁与谁通信：**将阅读伴侣添加为 Claude 连接器时，你的设备不会直接联系我们的服务——连接由 Anthropic 的云端代理。在 ChatGPT 上，则由 OpenAI 的云端代理。我们看到的是工具调用，而不是你本人。

访问方式

你的凭据是 Gumroad 收据上的许可证密钥（格式类似 XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX 的代码）。它用于识别购买记录，而非个人身份。服务会向 Gumroad 验证此密钥，缓存其哈希值一天，并对其进行速率限制。退款或停用的密钥将无法继续使用。请参阅 src/license.ts——整个机制都在这个文件中。

只有章节文本需要密钥。阅读伴侣的操作说明（activate）和每个 Implementation Block——即本书中的实操练习——均无需任何凭据即可获取；这些练习也发布在此处的 implementation-blocks/ 中。

连接

Claude（网页端或桌面端）——最简单的方法。 依次选择 Settings -> Connectors -> Add custom connector，然后粘贴：

https://mcp.runitonai.com/mcp

开始聊天时输入：Activate Run It on AI — my access code is <your license key>。

**ChatGPT。**使用“Run It on AI Companion”GPT（链接见书中），或者自行创建：新建一个 Custom GPT，并将 https://mcp.runitonai.com/openapi.yaml 导入为 Action。

Claude Code（终端用户）。

claude mcp add --transport http runitonai-book https://mcp.runitonai.com/mcp

**Codex。**在 ~/.codex/config.toml 中：

[mcp_servers.runitonai_book]
url = "https://mcp.runitonai.com/mcp"

此仓库包含什么

路径	内容
src/worker.ts	Cloudflare Worker：路由、传输机制、Gumroad 同步端点
src/license.ts	许可证密钥验证与缓存（访问控制）
src/auth.ts	验证旧版 bearer token（不会签发新令牌）
src/rate_limit.ts	基于密钥的速率限制
src/mcp/	MCP 协议基础设施（工具目录、分发、传输机制）
src/tools/	AI 可以调用的工具
openapi-v1.yaml	为 ChatGPT Actions 描述相同接口的文件
implementation-blocks/	书中所有 Implementation Block，以易读的 Markdown 格式呈现

两个数据文件以占位内容形式提供：src/data/chapters.json（书中的章节文本）和 src/data/skill.json（阅读伴侣的操作说明）。两者都在部署时根据书稿生成。本书的正文就是产品，因此不会放在公开仓库中——但提供正文的代码都在这里，Implementation Block（实操练习）也已完整发布在 implementation-blocks/ 中。

贡献者请注意：此仓库中的所有内容都由同步脚本从私有书稿仓库生成；书稿仓库中的 pre-commit hook 会在每次相关改动时重新同步。Implementation Block 位于书稿中；此处的副本是构建产物——请勿在此处编辑，否则改动会被覆盖。

自行运行

npm install
npm run typecheck
npm run dev        # local server on localhost:8787

wrangler.toml 中附带的是占位 KV 命名空间 ID；如果要自托管该 shell，请将其指向你自己的 Cloudflare 账户。

许可证

MIT — 详见 LICENSE。本书本身（章节、配套说明）仍为 StructLabs.io Pte Ltd 的受版权保护内容，不属于此代码库的一部分。