AI OS MCP Server

将 Felix 的 AI OS（已同步到 Notion）以 MCP 工具的形式暴露出来，这样任何兼容 MCP 的 AI 客户端都可以直接查询它，而不必再去抓取公开链接。

坦诚的局限： 这个项目在编写时实际上无法执行 npm install 或进行编译测试（其编写环境没有网络访问权限）。代码在已知范围内符合当前的 MCP TypeScript SDK 和 Notion 客户端 API 的形状，但在信任它之前，请亲自运行构建步骤并检查是否有错误——不要因为它写得很仔细，就认为它万无一失。

它提供的工具

• search_vault(query) — 对整个 AI OS 进行关键词搜索

• get_page(page_name) — 获取某个具名页面的完整内容

• list_projects() — 10_Projects 页面的当前内容

• get_project_status(project_name) — 单独获取某个项目的当前状态

Related MCP server: nooon

设置

1. 创建 Notion 集成

前往 notion.so/my-integrations → 新建集成 → 为它命名（例如 “AI OS MCP”）→ 复制“内部集成密钥”（以 secret_ 或 ntn_ 开头）。

2. 将 AI OS 共享给该集成

在 Notion 中打开 AI OS 根页面 → ... 菜单 → 连接（Connections）→ 添加你刚刚创建的集成。这一步不同于“分享到网页”——真正让集成的 API 调用能够看到这些页面的，正是这一步。

3. 设置 API 密钥

cp .env.example .env
# paste your key into .env

4. 使用 Docker 构建并运行

docker compose build
docker compose run --rm ai-os-mcp

这个服务器通过 stdio 运行——它设计为由 MCP 客户端（如 Claude Desktop 等）启动，而不是长期在终端里独立运行。

5. 让 MCP 客户端指向它

对于 Claude Desktop，请在其 MCP 配置（claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "ai-os": {
      "command": "docker",
      "args": ["compose", "-f", "/full/path/to/ai-os-mcp/docker-compose.yml", "run", "--rm", "ai-os-mcp"]
    }
  }
}

在信任它之前值得检查的事项

• npm install 能否干净地成功？或者是否与 SDK 存在版本不匹配？

• npm run build 是否能无错误地编译？

• search_vault 是否真的能返回结果——这取决于集成是否已按第 2 步共享给了正确的页面。

• get_page 中的表格内容可能渲染得比较粗糙——Notion 的 block API 是嵌套的，而这里只拉取了一层深度的表格行，未经深入验证。

它不做什么

不提供写入/编辑功能——设计上只读，因此不会意外修改 vault。也没有自动化触发——仍然需要 MCP 客户端按需调用，这与 AI OS 的“手动、聊天触发”执行决策保持一致。