# 安装 Apple Books

- 类型: MCP 工具
- 说明: 通过 Claude 访问 Apple Books 书库、批注、高亮与阅读进度，便于整理和回顾阅读内容
- 仓库: https://github.com/vgnshiyer/apple-books-mcp

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Apple Books" MCP 服务：
执行：claude mcp add 'io-github-vgnshiyer-apple-books-mcp' -- uvx apple-books-mcp
```

### Codex
```
请帮我安装 askskill 上的 "Apple Books" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-vgnshiyer-apple-books-mcp]
command = "uvx"
args = ["apple-books-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Apple Books" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-vgnshiyer-apple-books-mcp": { "command": "uvx", "args": ["apple-books-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env APPLE_BOOKS_MCP_ENABLE_WRITES=YOUR_VALUE --env APPLE_BOOKS_DATA_DIR=YOUR_VALUE --env APPLE_BOOKS_MCP_THREADS=YOUR_VALUE --env APPLE_BOOKS_QUERY_TIMEOUT=YOUR_VALUE --transport stdio io-github-vgnshiyer-apple-books-mcp -- uvx apple-books-mcp
```
需要环境变量：APPLE_BOOKS_MCP_ENABLE_WRITES, APPLE_BOOKS_DATA_DIR, APPLE_BOOKS_MCP_THREADS, APPLE_BOOKS_QUERY_TIMEOUT

### Codex
```bash
codex mcp add --env APPLE_BOOKS_MCP_ENABLE_WRITES=YOUR_VALUE --env APPLE_BOOKS_DATA_DIR=YOUR_VALUE --env APPLE_BOOKS_MCP_THREADS=YOUR_VALUE --env APPLE_BOOKS_QUERY_TIMEOUT=YOUR_VALUE io-github-vgnshiyer-apple-books-mcp -- uvx apple-books-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-vgnshiyer-apple-books-mcp]
command = "uvx"
args = ["apple-books-mcp"]

[mcp_servers.io-github-vgnshiyer-apple-books-mcp.env]
APPLE_BOOKS_MCP_ENABLE_WRITES = "YOUR_VALUE"
APPLE_BOOKS_DATA_DIR = "YOUR_VALUE"
APPLE_BOOKS_MCP_THREADS = "YOUR_VALUE"
APPLE_BOOKS_QUERY_TIMEOUT = "YOUR_VALUE"
```
需要环境变量：APPLE_BOOKS_MCP_ENABLE_WRITES, APPLE_BOOKS_DATA_DIR, APPLE_BOOKS_MCP_THREADS, APPLE_BOOKS_QUERY_TIMEOUT

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-vgnshiyer-apple-books-mcp": {
      "command": "uvx",
      "args": [
        "apple-books-mcp"
      ],
      "env": {
        "APPLE_BOOKS_MCP_ENABLE_WRITES": "YOUR_VALUE",
        "APPLE_BOOKS_DATA_DIR": "YOUR_VALUE",
        "APPLE_BOOKS_MCP_THREADS": "YOUR_VALUE",
        "APPLE_BOOKS_QUERY_TIMEOUT": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-vgnshiyer-apple-books-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJhcHBsZS1ib29rcy1tY3AiXSwiZW52Ijp7IkFQUExFX0JPT0tTX01DUF9FTkFCTEVfV1JJVEVTIjoiWU9VUl9WQUxVRSIsIkFQUExFX0JPT0tTX0RBVEFfRElSIjoiWU9VUl9WQUxVRSIsIkFQUExFX0JPT0tTX01DUF9USFJFQURTIjoiWU9VUl9WQUxVRSIsIkFQUExFX0JPT0tTX1FVRVJZX1RJTUVPVVQiOiJZT1VSX1ZBTFVFIn19
需要环境变量：APPLE_BOOKS_MCP_ENABLE_WRITES, APPLE_BOOKS_DATA_DIR, APPLE_BOOKS_MCP_THREADS, APPLE_BOOKS_QUERY_TIMEOUT