danpalmieri-books-for-agents

通过 MCP 访问结构化图书摘要知识库，支持搜索、阅读与发布。

## 概述（中文）

通过 MCP 访问结构化图书摘要知识库，支持搜索、阅读与发布。

## 技能正文

# Books for Agents（智能体图书库）

开源结构化图书摘要知识库，任何 AI 智能体可通过 MCP 访问。

## Setup

1. 若未安装 `books-for-agents` MCP 服务器，请添加：

```
claude mcp add --transport http books-for-agents https://booksforagents.com/mcp
```

或添加到你的 MCP 配置文件：

```json
{
  "mcpServers": {
    "books-for-agents": {
      "url": "https://booksforagents.com/mcp"
    }
  }
}
```

2. 连接后，可使用以下所有工具。

## 你能做什么

### 搜索图书

使用 `search_books` 按主题、关键词或问题查找图书。支持混合搜索（全文 + 语义向量嵌入）。

```
search_books({ query: "how to build better habits" })
search_books({ query: "leadership", category: "business" })
search_books({ query: "cognitive biases and decision making", limit: 3 })
```

### 阅读图书摘要

使用 `get_book` 按 slug 或标题（支持部分匹配）获取特定图书的完整结构化摘要。

```
get_book({ slug: "atomic-habits" })
get_book({ title: "Deep Work" })
```

### 阅读特定章节

使用 `get_book_section` 仅获取图书某一节 — 不需要完整摘要时可节省 token。可用节：`ideas`、`frameworks`、`quotes`、`connections`、`when-to-use`。

```
get_book_section({ slug: "the-lean-startup", section: "frameworks" })
get_book_section({ slug: "clean-code", section: "quotes" })
get_book_section({ slug: "thinking-fast-and-slow", section: "when-to-use" })
```

### 浏览分类

使用 `list_categories` 查看所有可用分类及每类图书数量。

```
list_categories()
```

### 建议新书

使用 `suggest_book` 将图书加入生成待办。对照已发布图书与现有待办检查重复。

```
suggest_book({ title: "Thinking in Bets", author: "Annie Duke", category: "psychology" })
```

### 查看待办

使用 `list_backlog` 查看所有待生成图书及其状态。

```
list_backlog()
```

### 生成图书摘要

使用 `generate_book` 获取生成下一本图书摘要所需的模板、示例、元数据与说明。可指定标题或让其选择下一个待办。

```
generate_book()
generate_book({ title: "Never Split the Difference" })
```

生成内容后，调用 `submit_book` 发布。

### 发布图书摘要

使用 `submit_book` 将生成的摘要直接发布到知识库。在 `generate_book` 生成内容后调用。

```
submit_book({
  slug: "never-split-the-difference",
  title: "Never Split the Difference",
  author: "Chris Voss",
  category: "business",
  content: "---\ntitle: \"Never Split the Difference\"\n..."
})
```

## 提示

- 只需一部分时用 `get_book_section` 而非 `get_book` — 可显著节省 token。
- 用自然语言查询 `search_books` — 语义搜索理解含义，不仅是关键词。
- 生成图书时严格遵循 `generate_book` 返回的模板与说明。所有内容必须为英文。
- 图书间关联使用 `[[slug]]` 格式，且只能引用已有图书。